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INTERESTING TIMES 


ometimes, I 

admit, I 

struggle to 

find topics 
for this editorial 
piece. There is only 

es -so much you can 

say about Ubuntu, Free Software, and 
Linux before you start repeating yourself. 
But there is no danger of that this month, 
oh no! There is enough in the news on 
Ubuntu to fill a book, let alone, one side 
of an A4 page. 

In quick succession, Mark Shuttle- 
worth announced there would be no sta- 
ble version of Unity 8 after all (and 17.10 
Ubuntu would be returning to Gnome), 
Canonical was ending its “convergence” 
adventure (which means no more Ca- 
nonical-backed Ubuntu Phones), the Mir 
project was getting cancelled, Jane Silber 
resigned, and Shuttleworth himself took 
over as CEO like back in the old days. 

Shuttleworth later revealed that all of 
the above was part of the preparations 
for taking Canonical public. It makes 
sense from a business point of view: Ca- 
nonical’s end-user projects, its desktop, 
Ubuntu Touch, and so forth, have not be- 
come profitable, no matter how many re- 
sources and how much money was 
thrown at them. The server, virtualiza- 
tion, and cloud business units have been 
making money since 2015, however. 

When launching an IPO, one wants to 
present a lean and profitable company to 
prospective investors. They are, after all, 

in it exclusively for the money. 

Should we, the end users, be worried? 


INFO 

[1] Yunit: https:/yunit.io/ 

[2] Smoose: https:/www.smoose.nl/ 
[3] UBports: https:/ubports.com/ 


Dear Ubuntu User Reader, 


Will we be left out in the cold, with a 
platform that will slowly languish away 
due to a lack of updates, until it becomes 
unusable? 

Unlikely. Firstly, Mark Shuttleworth 
gets a lot of hate from several sectors, 
but, despite often making decisions that 
ruffle some feathers, he is definitely not a 
heartless villain. Quite the contrary, I 
have personally met him several times. 
He is a nice guy, and he is quite selfless 
in wanting to improve Linux users’ lot. 
Ubuntu for end users may not be part of 
Canonical’s business plan, but it still is 
part of Shuttleworth’s vision. Having a 
person with Shuttleworth’s sway, re- 
sources, and charisma behind a project 
goes a long way. 

And this sort of thing has happened 
before: When Red Hat closed their free 
(as in beer) project, users were up in 
arms. But supporting Fedora has turned 
out fine for the community. It is easy to 
imagine that Shuttleworth would have 
Canonical sponsoring community-driven 
projects that use Ubuntu-based technolo- 
gies, even those that cater to end users. 

Secondly, even in the really, really un- 
likely case that Shuttleworth/Canonical 
were to cut off the end-user limb com- 
pletely, an open source project doesn’t 
die unless the community wants it to. 
Say what you want about Canonical, but 
all of their tech is available openly to the 
community, and there is already at least 
one fork of Unity 8 (check out Yunit oy) 
that will be ported to Wayland, and a 
Dutch group of hackers has started a 
business [2] and a community-backed 
project [3] that are working on further 

developing and porting Ubuntu Touch/ 
Phone to as many terminals as they can 
lay their hands on (check out our article 
on Ubuntu Touch on the Fairphone 2 in 
this very issue). 
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Finally, there is too much riding on 
Ubuntu for end-user oriented projects to 
just give up on it. Linux Mint, all the tra- 
ditional derivative flavors of *buntu 
(Xubuntu, Lubuntu, Kubuntu, etc.), new 
arrivals like neon, and so on and so forth 
will keep the repos stocked and the PPAs 
on Launchpad updated. 

A final thought: GNU/Linux was born 
with a community and is one of the most 
successfully crowdsourced projects ever. 
There is no way that this is going to have 
a major impact on the bigger picture. 
Even if the worse happens and things 
like Unity, Ubuntu Phone, and so on lan- 
guish (allow me to reiterate, this is so 
improbable it is hardly worth consider- 
ing), there are plenty of other user-ori- 
ented projects that will gladly give 
Ubuntu users the haven they need. 

There is an ironic Chinese saying that 
goes: “May you live interesting times.” 
This may be apocryphal, but apparently 
you say this to enemies, and it is more a 
curse than well-wishing. The irony 
comes from the fact that “interesting 
times” are usually convulsive and often 
catastrophic for those who have to en- 
dure them. 

But Ubuntu users are living some in- 
teresting times, and it doesn’t have to be 
bad at all. 


av 


Paul C. Brown, 
Editor in Chief 
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There is the idea that Linux and, by extension, Ubuntu, is 


l] Well beyond the experimental stage 


only good for developers and experimenting. This perception 


is wrong. 


Working with Makagiga 
Makagiga is an integrated 
solution that takes on numerous 
tasks in the day-to-day office 
setting and replaces some tools 
that are part of your desktop. 
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are the ingredients of the drama unfolding at 
Canonical right now. 
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GnuCash is a powerful financial accounting program that is 
well suited for both personal and small business finances. 


Tools for (budding) novelists 


When writing fine literature, specialized word processors 
can help you stay on task, allowing you to shape your 
suspense-laden storyline and characters. To this end, we're 
examining four free authoring tools. 
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Ubuntu 17.04 — Zesty Zapus 


The latest and greatest Ubuntu has just 
landed on our double-sided DVD. 


Ubuntu 17.04 comes with... 
e Simplified software management 
e Apt and Snap package managers 
e Prepared for Steam gaming 

e Linux kernel 4.10.0 

e LibreOffice 5.3.12 

e Advanced hardware detection 
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The Spigot calculator distinguishes itself with its high The ultra-slim web server HTTPie is an elegant synthesis of 
accuracy and precise results from the shell. curl and wget, making it ideal for use with pipes. 
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KDE Plasma activities Eskil graphical diff tool 
KDE Plasma Activities remove the limitations of having a With Eskil, you can easily compare the differences between 
single desktop and allow you to have multiple environments files. If necessary, you can even compare them with a 


with their own sets of launchers for applications, files, and version control system. 

URLs, each customized for a single purpose. 

Trojitá IMAP client at Offline route planner 

hl Trojitá is new to the scene of email clients, but it already ~ Routino is an offline route- 

stands out for its intuitive interface and speed. Even so, this E Np planning application that 

client is still missing some essential functions. ] OpenStreetMap data to c 
efficient and convenient routes 

Eko sound editor We discuss what this software 

If you can master the idiosyncrasies of this software, then can do 

you will be able to edit audio files in a flash. 
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Fairphone 2 with Ubuntu KDE Slimbook on review 

The Fairphone 2 strives for a balancing act. As an open The KDE Slimbook bolsters the ranks of Linux notebooks 
platform it offers easy repair and freedom of choice in terms with this good-looking and powerful Ultrabook. 

of its operating system, while trying to ensure raw material 
mining and production take place under fair conditions. 


Discovery Guide a 


If you are new to Ubuntu, these tutorials will help you get ş 


70 Installing Ubuntu 17.04 76 Package Management 
We help you get started by walking you Ubuntu's Software app lets you install just 
through the process of upgrading or about anything. Discover the program that 
installing the latest Ubuntu release with will open up a universe of free software. 
step-by-step instructions. 79 Multimedia 

74 Network and Updates You can configure your Ubuntu system 
Learn how to use Ubuntu's to support movies, music, and Internet 
NetworkManager to access your WiFi and telephony. Learn all about some favorite 
download updates. multimedia apps and games. 
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Usuntu 17.04 — Zesty ZAPUS 


Ubuntu 17.04 — Zesty Zapus, 32 & 64 bits 


ONE DVD 


This month, on our double-sided disk, we have the newest ver- 
sion of Ubuntu, 17.04 — Zesty Zapus. It comes with updates and 
changes you won't want to miss. 


Zesty comes with the new graphical software installer intro- 

duced in 16.04. The command-line suite of Apt tools has also 

received a facelift making it much easier to use. The Snap sys- 

tem of self-contained packages has a growing catalog of pack- 

i Pokal) ose: ages for you to choose from. 
anala aia E On side B, you'll find the 64-bit version of Ubuntu. This version 
č 4 < will work better on more modern machines and will deliver a 

faster and more optimized experience. If in doubt, try this ver- 
sion first. 
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Side A comes with the 32-bit version of Zesty, ideal for older 
machines or if you have compatibility problems with libraries 
or apps. 
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DouBLE-SipeD DVD 
This DVD is a double-sided Live disk. 
You can try out the operating system 
on the disk without installing anything 
on your computer. You can later install 
the 32- or 64-bit version of Ubuntu 
from the Live desktop. 


The DVD has a label on side A of the 
disk, so, if you want to run the 64-bit 
version of Ubuntu, the side with the 
label should be facing up in the tray. If 
you want to use the 32-bit version, 


you should insert the disk with the 
[2] Ubuntu: http:/www.ubuntu.com label facing down. 


ADDITIONAL RESOURCES 


[1] Ubuntu User: http://www. 
ubuntu-user.com 
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There is the idea that Linux and, by extension, Ubuntu, is only good for developers and 
experimenting. This perception is wrong. 


Linux has long since transcended the experimental stage 


BEING PRODUCTIVE 


BY PAUL C. BROWN 


his happened back in the early 

days of Linux, if I remember 

right, between the early- to mid- 

2000s. I met a person, let’s call 
him Sam, who used Linux, but dual- 
booted, because he said that when he 
needed to work, he used Windows. He 
was totally enthusiastic about the idea of 
an open source operating system, but 
found the applications lacking and the 
platform too unstable. Microsoft Office, 
CorelDRAW, and Outlook were tools he 
could not do without. Linux was “for 
playing,” for tinkering and experiment- 
ing. 

Things have changed. Now, when I 
meet people who dual-boot, the say it is 
usually because they want to play... on 
Windows. Of course, it is not the same 
“playing” Sam was talking about. In this 
case it is literally playing. Support for 
games and hardware that the games 
need have traditionally been better on 
Windows. Interestingly, this again is 
shifting, with Linux emerging as a very 
capable gaming platform in its own 
right. But that is a topic for another day. 

To get back on track, although I still 
get the occasional “I can’t use Linux; I 
don’t know how to program,” the fact 
is Linux has become a perfectly good 
platform with which everybody can 
work everyday. We have all the usual 
accoutrements: word processors, 
spreadsheets, presentation software, 
visual database browsers, groupware 
clients, design applications, and so on; 
but Linux comes with a second level 
of productivity in that it is also very 
capable of running the back ends that 
power those same desktop apps. The 
same machine you use to access a da- 
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tabase on can run the database engine 
itself in the background. You can have 
one off-the-shelf computer running 
the same Linux you use on your desk- 
top, running your personal cloud. You 
can collect and host emails, calendars, 
and contacts on your Linux box, in- 
stead of having to rely on a third party 
- that could sell your data for profit. 
But there is even a third level of pro- 
ductivity we often overlook when talk- 
ing about office tools and workflows: 
the command-line productivity stable of 
applications. We often think of terminal 
tools as belonging exclusively to the 


realm of developers and sys admins. Not 
so. We have seen in Ubuntu User so 
many utilities to process text files, con- 
vert images, and collate and organize 
data, that we have lost count. These 
apps have the advantage of being light- 
weight, can be used easily remotely 
(through, say, ssh), and are ideal for so- 
phisticated batch processing. 

In this issue, we will be looking at 
some of the ways you can fully exploit 
all three levels of Linux productivity and 
how to make the most of desktop apps, 
servers, and terminal tools for your ev- 
eryday work.e 


kchung, 123RF 
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MAKAGIGA 


Makagiga is an integrated solution that takes on numerous tasks in the day-to-day office setting. It 
also replaces several of the small tools that are part of your desktop. 


Working with Makagiga, the digital office 


ALL INCLUSIVE 


BY ERIK BARWALDT 


nlike other operating systems, 
Linux desktop environments usu- 
ally include a multitude of small 
applications that range from elec- 
tronic notebooks and image viewers to RSS 
readers. All of these applications help to 
make daily work in an office setting easier. 
However, it is most often the case that the 
various tools have to be individually called, 
they are not connected to one another, and 
menu navigation frequently varies from 
one tool to the next. As a result, it can take 
some time to become familiar with how a 
tool works. Moreover, simultaneous opera- 
tion of several tools can be inconvenient. 
Makagiga [1] takes a different and inte- 
grated approach to providing tools for daily 
use. Distributed under the free Apache 2.0 
license, the solution has a uniform inter- 
face covering a diverse selection of small 
programs. The programs dovetail into one 
another, thus making for efficient use. 


INSTALLATION 

Makagiga is available for download as a 
7Z archive from [1]. The archive is about 
33MB in size, Install 7Z with 


sudo apt install p7zip-full 


and download the Makagiga archive. 
Once the download is complete, decom- 
press and extract the archive to the di- 
rectory of your choice: 


7z x makagiga-file.7z 


Makagiga was developed as a Java applica- 
tion, and as a result, it requires a Java run- 
time environment. Here, both Java from 
Oracle and the free OpenJDK environment 
are suitable. 

You may want to move the newly cre- 
ated makagiga-5.8.1 directory to the /opt/ 
directory where newly added software is 
usually stored. Next, you can set up a 
launcher in your menu structure. The de- 
velopers have integrated a small shell script 
called makagiga.sh that allows you to 
launch the program instead of having to 
type out the inconvenient Java call. 

Once launched, the main window opens 
quickly. The window contains a tree direc- 
tory view for folders and feeds to the left 
and a large pinboard to the right. Tabs are 
used to show changing content in the pin- 
board (Figure 1). 

A horizontal menubar sits at the top of 
the main window. The three pinboard tabs 
(Widgets, Calendar, and To-Do) represent 
tasks and shortcuts that might potentially 
be helpful. You can switch Makagiga to 
full-screen view using the menu option 
View | Full screen or by pressing the F11 
button. In full screen-view, the software 
gives the impression of a quasi-desktop. 


UNCONVENTIONAL 
Makagiga contributes an unusual inter- 
face to the desktop, as well as an uncon- 
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tings dialog under the settings option of 
both the View (sometimes - see below) 
and Tools menu. You can use these dia- 
logues to configure the software. Since 
the menu structure changes when a pin- 
board tab has been activated, you can 
find the settings dialog for designing the 
view if the Widgets tab is selected. The 
three context-sensitive menus (Wallpa- 
per, Colors and Border, and Workspaces) 
are used to enhance the pinboard’s vi- 
sual appearance. Basic modifications, on 
the other hand, are performed in the 
Tools | Settings menu. 

The General tab in this menu allows 
you to define the software’s behavior 
during operation and when it stops. The 
Browser menu item lets you specify the 
browser that will start when links are 
called in Makagiga. You should select a 
theme with the Look and Feel option. 
The Tasks dialog is used for defining cer- 
tain options for the visual appearance 
and notification function of the to-do 
lists. The Notepad area determines addi- 
tional options for the notepad, such as 
the standard font and coloration. To the 
extent that you would like to modify the 
automatic update function, you can 
modify corresponding options accord- 
ingly in the dialog of the same name. If 
you are also using an RSS feeder, then it 
is a good idea to adapt parameters like 
the update interval or the period of time 
during which news should be locally 
saved (Figure 2). 


WIDGETS 

By default, Makagiga opens the Widgets 
page on the pinboard each time the pro- 
gram starts. This segment displays the 
actual workspace, which can be filled 
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work elements. It 
lets you arrange 
and administer in- 
dividual notes. You can also assign titles 
to each note, plus you can use the Set- 
tings button at the bottom edge of a note 
to create a customized look-and-feel for 
the note. The note’s content can be 
printed out using the print icon located 
again at the bottom edge that appears 
when a note is selected. 

There are two methods for adding ad- 
ditional widgets to the pinboard. The 
first is to select Add Widget in a context 
menu that you call by right-clicking in 
free space. This will cause four different 
alternatives to appear. The second 
method is to click on the Add Widget 
button sitting above the pinboard. This 
allows you to distribute the widgets onto 
two work areas, which are called using 
the 1 and 2 buttons directly above the 
pinboard. 

Since Makagiga has been built with a 
modular design, you can add additional 
elements. The selection of different 
themes for modifying the visual appear- 
ance ranges from the display software 
for various file and image formats to 
clocks that can be placed on the desk- 
top. Even small search tools are avail- 
able. All of the widgets are compatible 
with the pinboard. In addition to notes, 
you can install images, clocks, and a cal- 
endar on your clipboard. Clicking on the 
Get More Widgets option in the Edit 
menu lets you download additional wid- 
gets from the Internet. To install a new 
widget, you simply mark it and then 
click on the Install button at the bottom 
left of the window. A download follows, 
and then comes installation. Afterwards 


dialogs. 
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Figure 2: Makagiga collects all of the important options in the settings 
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Figure 3: Numerous additional widgets are available for download from 


RSS reader. 


you will need to restart the program 
(Figure 3). 

To remove widgets, go to the Tools | Pl- 
ugins dialog and click on the red check 
mark found next to the relevant widget. 
The widget will be deleted after you 
have answered a security question that 
pops up. 


CALENDAR 

You can add a calendar tab for the cur- 
rent month by selecting Tools |Calendar. 
Right-clicking on a given date lets you 
enter an item. A control bar found di- 
rectly above the calendar indicator lets 
you change the month that is displayed. 


TASK PLANNER 

From the Files and Folders in the tree 
view on the left, you can choose To-do 
list to open a tab that allows you to take 
care of task planning and links this ac- 
tivity to the calendar. Task deadlines en- 
tered into the planner find their way au- 
tomatically onto the corresponding date 
in the calendar. It is also possible to des- 
ignate a particular time and define prior- 
ities for tasks. The various priorities can 
be displayed using a multicolored back- 
ground in the task list. This provides the 
user with a quick overview of what 
needs to be done first. Completed tasks 
can be designated by crossing off the 
corresponding entry in the to-do list. In 
order to keep better track of what has 
been accomplished, it is also possible to 
delete individual entries. This can be 
helpful when a large list of tasks is in- 
volved. Removing a task from the list is 
accomplished by right-clicking on the 
relevant entry, then selecting the Selec- 
tion option in the context menu, and fi- 


Figure 4: You will always know what is going on thanks to the built in 


nally selecting the Delete selection op- 
tion. 

In order to add additional tabs to the 
pinboard, click on the New button above 
the tree view and add another entry. 
Make sure that the new entry is added to 
the tree structure at the right location. 
You should definitely consider adding 
entries to prepare the tree view’s basic 
level with new folders for projects and 
activities before using the software pro- 
ductively. This will permit you to make 
modifications later without having to re- 
arrange entire hierarchies. 


RSS READER 

Makagiga also comes with an internal 
RSS reader, which constantly updates 
your subscription news. The RSS Feeds 
entry is found in the tree view to the left 
of the main window. As soon as you 
click on it, you will see the existing feeds 
roll down. When the program is first in- 
stalled, there are already some example 
feeds entered into the list. These can be 
easily removed by right-clicking on the 
feed you want to delete and then select- 
ing the Delete option in the menu that 
opens. 

You can integrate any desired feeds 
into the system using a corresponding 
dialog. All you need to do is copy and 
paste the relevant target URL for the 
website into the address line of the in- 
stallation dialog. After this, click below 
and to the right on Preview. After a short 
wait, you will see the latest headlines 
and teaser content for the feed in the 
window’s preview area. Clicking below 
to the right of the window on Create 
causes your system to accept the new 
RSS feed. As soon as you click on the 
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RSS feed’s entry in the tree view in the 
left area of the window, the individual 
feeds roll down. A click on one of the 
feeds brings it up to date. Right-clicking 
on the main entry RSS-Feeds and then se- 
lecting the Refresh Feeds: RSS-Feeds up- 
dates all of the feeds that have been inte- 
grated into Makagiga. After finishing the 
update, the program will show you the 
title of the most recent feed entry and 
the number of new notifications in the 
system tray at the bottom left. If you 
click on one of the feeds in the left part 
of the window, the program will display 
the title for the most recent notifications 
for this feed in the form of a list. When 
you click on the notification, Makagiga 
opens a new folder on the right of the 
workspace and displays the notification 
together with the available information 
(Figure 4). 

To close the tab once you have fin- 
ished reading, right-click on the tab it- 
self, and then click on Close in the con- 
text menu that opens. This causes Maka- 
giga to close the tab and go back to the 
previous one. Individual feeds to which 
you do not want to subscribe are re- 
moved from the list by right-clicking on 
the relevant entry and choosing Delete in 
the context menu that then opens. 


ON SETTINGS 

It is especially important when fre- 
quently updated RSS feeds are involved 
to regularly delete notifications at fre- 
quent intervals. This cleans out the main 
memory. Therefore, Makagiga provides 
diverse settings for automatically dealing 
with RSS feeds. You find these by right- 
clicking on RSS Feeds in the tree struc- 
ture on the left and then selecting Set- 
tings: RSS Feeds in the context menu. In 
the straightforward dialog that opens, 
you can now specify various settings for 
updating and deleting feeds. You can 
also modify the appearance of the indi- 
cator (Figure 5). 


SEEK AND YOU SHALL FIND 
The tree view in Makagiga can become 
confusing especially when lots of functions 
are used repeatedly. This means that rou- 
tine tasks like searching through RSS notifi- 
cations can become noticeably more diffi- 
cult in comparison to searching with a 
fresh installation of the application. 
Makagiga seeks to avoid this issue with a 
search function underneath the tree view. 
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Figure 5: The dialog for specifying important 
settings for the RSS feeds. 


This function lets you enter a random 
search term in the entry field. The software 
then lists the search results in the tree view, 
practically in real time. The Sort By option 
underneath the search field lets you choose 
various search criteria to filter the results 
(Figure 6). 

Regularly recurring searches can also be 
saved making it unnecessary to enter the 
terms each time. 

You will also find another Tasks button 
underneath the search field and the Tree 
button. The latter button determines the 
display of the left window segment. It is ac- 
tivated by default. Clicking on this button 
causes the program to switch from the tree 
view to the task list, which lists the individ- 
ual tasks sorted by time period. This gives 
you an immediate overview of the tasks 
that need to be completed in the short run. 
The priority of each task can be displayed 
if desired. 


CONCLUSION 

Makagiga is an enormous help for users 
who primarily use a PC to organize their 
workload. Although it takes some time to 
get used to the software due to its wide- 
ranging potential, Makagiga does replace 
many useful programs that would other- 
wise be external, like an RSS reader, an 
electronic notepad, and calendar adminis- 
tration. The possibility of collecting various 
components in individual folders also 
makes Makagiga suitable for use as a small 
project administrator. The software is ap- 
pealing for its brisk operation. The only 
shortcoming is found in the area of local- 
ization with some foreign countries. How- 
ever, there are ways of getting around this. 
Users seeking greater ease in keeping an 
appointment calendar and keeping their 
desk clear of little pieces of note paper 
should definitely take a look at Makagiga. e 
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Figure 6: You can quickly find your way through 
larger volumes of data with the help of the 
search function. 


INFO 


[1] Makagiga: https:/sourceforge. 
net/projects/makagiga/ 
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PAPERWORK 


Qu 


Digital archives do away with the need for traditional filing cabinet storage. Even so, Paperwork 


tries to make your life easier. 


Use Paperwork to digitize and archive documents 


PAPER TRAIL 


BY KARSTEN GUNTHER 


he idea behind Paperwork 

originated with the desire to 

have a paperless office. Let- 

ters, bills, and loose pages are 
loaded into a scanner, which spits 
out PDF and JPEG files into the in 
tray. Then, the contents of these 
files are converted with OCR into 
digital form. 


This is where Paperwork [1] comes 
into play. The application collects 
image data and text, overlaps them, 
and then saves them as a PDF. Pa- 
perwork creates a summary of the 
text content for the prepared docu- 
ments as a searchable index. How- 
ever, there are some pitfalls inherent 
to this process for which you should 
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watch out. The scans and photo- 
graphs will need to have the highest Scant Fealibration 


eneral 

possible resolution so that the soft- ie Wok directory, impapers 5 gan 
ware is able to properly recognize 
the text. This means that a good Kesnar 
scanner with at least 600 DPI resolu- Device | Brother MFC:7320 meni 
tion is a must. Default source Flatbed y z 

During start up, Paperwork first Resolution 300 (recommended) a 
looks for Tesseract [2]. If it cannot 

i i i PCR 
find this powerful OCR engine, then AEAN 
the program will use CuneiForm. In Language | English x 
most cases, you will get the best re- 
sults with Tesseract. You can install 
it with: 

sudo apt install tesseract-ocr 2 


tesseract-ocr-eng - 


Incidentally, while parsing a page, 
Paperwork quite literally takes an in- L = 
teresting turn here. If it cannot de- Figure 1: Paperwork has been designed with just a few settings. Even so, this does not necessar- 
termine the orientation for a ily make the software easier to use. 

scanned page, it will simply process 
the page four times by turning it 90 
degrees with each version and then 
use the best results. 


INSTALLATION 
You will find general installation in- 
formation in Paperwork’s Git Reposi- 
tory [3]. The most up-to-date ver- 
sion 0.32 is not presently in Ubuntu 
and its derivatives’ repositories. A 
However, a PPA exists, and the infor- 
mation about installation procedures 
is online [4]. 

To install from source (which 
worked fine for us), first install 
some Python dependencies: 


Paperwork 1.1.1 


sudo apt install python3-pip 2 
python3-setuptools python3-dev 2 
python3-pil install libenchant-dev 2 
python3-whoosh 


Figure 2: Paperwork’s functions are hidden behind plain and ordinary looking buttons at the top of 
This will install, among other things the main pane. 
pip, the python utility for installing 
and updating Python-based apps and paperwork-shell chkdeps 2 


libraries directly from Python's re- paperwork_backend 
positories. 
With pip, you can now install Pa- and 


perwork proper: 
paperwork-shell chkdeps paperwork 
pip3 install paperwork 
and follow the on-screen instructions. 
The final step is to check and install 
for more dependencies Paperwork may ARCHITECTURE 
need. To do that, use the commands: The application itself is primarily based on 
four components. Paperwork uses SANE 
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(A Search K 
New document 

lf you don't have the right tools, comparing POF documents for differences cé 

cumbersome. We discuss five nifty tools that can help with this task. 


| Finding differences in POF documents 


LOOKING FOR TR 


BY FRANK HOFMANI 


grams including Md 
totext [2], Pafdift | 
14] and Diff{PDF [5] 
can be found in the! 
tories and that of m 
butions 


he portable document format, 

or PDF, has become indis 

pensable as a way to exchange 
a across various platforms 


and operating systems. This is espe- 
cially true for documents that 
should be readable but not easy to 


weoamiue Eure | 


Figure 3: After the OCR process is complete, the software will display what it has recognized 
when you mouse over a word. In this example, the software has incorrectly split the word LOOK- 
NG into LOOK and NG, as it was unable to correctly identify the |. 


arch 


New document 


07/05/17 


07/05/17 


L 


Figure 4: Paperwork keeps its tidy appearance even after a series of documents have been read in. 
The software displays the selected document as a preview. 


sudo apt instal] sane xsane 


for scanning documents. It processes 
the documents with Tesseract or Cu- 
neiForm. Whoosh [5] is used to indi- 
cate text that has been altered by 

OCR. In addition, this tool automati- 
cally generates recommendations for 
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keywords. In the process, it reduces 
each word to the word stem in order 
to arrive at meaningful results. 
There is a graphical interface that 
has been developed using GTK/ 
Glade, which puts all of the compo- 
nents together. 

The preferred OCR engine origi- 
nally comes from Hewlett Packard. 
Google uses the open source library 
for things like digitizing books. The 
software distinguishes itself with 
high recognition rates and extensive 
automation. 

Since Tesseract works exclusively 
with uncompressed TIFF files, it is 
necessary to first prepare the 
scanned pages. Based on experience, 
this is a demanding task that can 
only partially be automated. Herein 
lies one of the weaknesses of Paper- 
work. Programs like gscan2pdf [6] 
offer more possibilities. 

Paperwork creates a searchable 
PDF text file from the prepared 
pages. Currently, the software sup- 
ports direct scanning, reading in 
PDF documents, and analysis of 
scanned images. Modern image for- 
mats like JPEG 2000 are not sup- 
ported, but the software does sup- 
port the classic JPEG and PNG for- 
mats. 

Even so, it is not possible to si- 
multaneously load multiple image 
files in a project. Nor is it possible 
to load an entire folder with scanned 
images. This makes it inconvenient 
and tedious work when you want to 
continue to process existing scans. 


SETTINGS 
To date, it is only possible to config- 
ure for a few parameters. You can 
specify a folder for saving informa- 
tion, the scanner, and the OCR en- 
gine (Figure 1). The language set- 
tings control the spell check, but 
this was not successful in the test. 

There is a user-specific configura- 
tion file ~/.config/paperwork.conf. 
This is where you can check to see 
whether the program is actually 
using the correct language and spell 
check for the OCR engine. Note that 
this feature does not work accurately 
in all versions. 

If Paperwork does not recognize 
words that contain a language-spe- 
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cific character, then this is an indi- 
cation of an error in the language 
setting. To resolve this problem, you 
should first close the application 
since this will cause it to write back 
the configuration file. Next you 
should use an editor to enter en as 
the value for the corresponding lang 
variable in the [OCR] section. After 
switching the language, you should 
restart the text recognition. 

If you operate a number of differ- 
ent scanners, then it is important to 
make sure that you select the appro- 
priate scanner. You should take care 
to set the resolution correctly. Test- 
ing did not reveal why the applica- 
tion recommends only 300 DPI with 
some devices that have a physical 
resolution of 600 DPI. 


PRACTICAL EXAMPLE 

Once started, Paperwork displays a 
clean looking interface that contains 
two sections (Figure 2). To the left 
you will see a database in which the 
current document has been high- 
lighted (in Figure 2, the new docu- 
ment is currently empty). The pro- 
gram displays the pages of this docu- 
ment that have been scanned and 
processed in a corresponding pre- 
view. 

A single mouse click on one of the 
pages shown in the preview causes 
an original-sized version to be dis- 
played. This lets you review the de- 
tails of what the program has recog- 
nized during the OCR process (Fig- 
ure 3). 

There are a number of buttons, 
some very inconspicuous, located at 
the top edge of the screen. They are 
used for calling program functions. 
The arrows in Figure 2 point to the 
location of the buttons. The leftmost 
button controls document viewing. 
Options for reading in data are 
found under Scan. The rightmost 
button is used to manage special set- 
tings. 

The software collects images that 
have been scanned in as projects 
and then exports them as a PDF file. 
In carrying out this process, the soft- 
ware sets up for each project a suit- 
able subdirectory in the database di- 
rectory. The name of the subdirec- 
tory follows the convention Date < _ 


WWW.UBUNTU-USER.COM + UBUNTU USER 


Date _ = = 
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Labels 
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Figure 5: If necessary, you can provide additional information about selected documents like the 
abels “document” and “PDFs” shown in the example. 


Date 
07/05/17 

Labels 

v) HE compare 
OE document 
- MMM o: 


+ 


Additional keywords 
document 


Figure 6: You can use labels, colored markings, and keywords to add more information to a docu- 
ment. 


ID-Number. However, only the date 
appears in the front end, which 
makes it difficult to search for a 
project you are looking for (Figure 
4). 

By default, Paperwork uses the ~/ 
papers/ folder as a working direc- 
tory. The software always sets up 
several files in the project directory. 
You will find JPEGs of the scanned 
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PAPERWORK 


Hightightwords GT) ie 


eOmecsaoc 


ous E3 


Ga ee 
Figure 7: After scanning, the program shows the last page that has been read in, and you can 
choose to see the words it has identified. 


(a search ie 
New document 
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Figure 8: Conspicuous problems occur with the OCR process. In spite of the fact that Tesseract is a 
good and powerful OCR engine, Paperwork still manages to create error-ridden texts from PDF 
documents. 


page under paper. < Number > .jpg. 
Text extracted by the OCR engine is 
found under paper. < Number >. 
words. 

A labels file contains headings if 
they have been manually assigned 
(Figure 5). The PDF file that is cre- 
ated always has the same name doc. 
pdf in this directory. 
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The extracted texts are located in 
the project directories, but they do 
not exist as simple text files. Instead 
they exist as special XML files in 
hOCR format [7]. In this format, 
markings indicating the position in 
the original document are shown 
alongside the pure text that the files 
contain. This makes it possible to be 
precise when overlaying the text 
onto the image files. 

After a document has been gener- 
ated as a project, you can assign ad- 
ditional headings even if these head- 
ings are not found in the document 
and the OCR process does not recog- 
nize them. Assignments are made by 
means of a button that appears on 
the selected document. 

In addition, you can choose an ex- 
isting label or add new labels with 
the corresponding button. The head- 
ing editor will appear, which allows 
you to link colored markings to the 
document (Figure 6). These abstract 
markings prove to be conceptually 
interesting, but turn out to be only 
of limited value. This is because the 
software does not let you sort or 
search according to these criteria. 

The application makes it possible 
to influence the results of a scan. To 
do this, you should go to the Set- 
tings dialog and start the Scan func- 
tion by pressing the button. You 
should also specify the areas in 
which the software will find the rel- 
evant text. 

The software will show a preview 
after it scans each page. You can 
choose to have the program high- 
light each word by clicking on the 
button shown in Figure 7 and then 
toggling Highlight words to ON. 


PROBLEMS 

Paperwork displays significant short- 
comings in terms of the OCR recog- 
nition rate. The program commits an 
array of errors even when dealing 
with good scans and PDF text docu- 
ments. The spellcheck is not of 
much use (Figure 8). 

When creating the index, the ap- 
plication collects words that have 
been extracted from the texts. The 
user cannot influence what goes into 
the index and what does not. Assert- 
ing your control over the index pro- 
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Figure 9: Advanced Search makes it possible to search for multiple linked keywords. 


ALTERNATIVES TO PAPERWORK 


In the meantime, there are a number 
of possibilities for providing scanned 
documents with a text layer. Gscan- 
2pdf is well-known and also proven in 
practice. Other alternatives would be 
xsane2djvu and OCRmyPDF [8], which 
also often achieve good results. The 
advantage to gscan2pdf is that it per- 
mits extensive preparation of the 
pages before they are sent to the OCR 
engine. 

Recoll [9] is a good choice when you 
want access to text contained in vari- 
ous formats but without explicit OCR 
processing. This program does not 
use a database at all with the index. 
Instead, it recursively monitors and 
processes an array of directories that 
have been previously uploaded. Rec- 
oll recognizes numerous different for- 
mats and provides the option of con- 
trolling the search function. 


Text PDF documents require almost 
no preparation for loading into a data- 
base. Programs like Calibre [10] do 
this easily and mostly error free. Al- 
though it was developed for manag- 
ing ebooks, the program loads and 
displays text, HTML, ODT, and PDF 
documents. 


However, Calibre cannot handle a full 
text search unless certain precautions 
are taken. Meanwhile, several plugins 
are available as retrofits. Some of 
these are based on Recoll. The combi- 
nation of Calibre with Recoll proves to 
be a good solution for saving and ad- 
ministering documents in various for- 
mats. Gscan2pdf can be added to the 
mix and used for the OCR processing. 
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cess would require that you learn 
Whoosh, which is quite an under- 
taking. The indexer is fairly effi- 
cient, but, currently, Paperwork does 
not make optimal use of this tool. 

Paperwork saves the index in the ~/ 
-local/share/paperwork/index/ direc- 
tory, thus independently from the da- 
tabase. This causes some headaches 
when you are looking for portable 
management of a large number of doc- 
uments. You will find a number of files 
containing the extracted keywords in 
the directory, but the files are not nec- 
essarily directly legible. 

To date, the program does not pro- 
duce document titles that are mean- 
ingful. Nor is it possible to change a 
title manually. This process would be 
helpful, especially if you are dealing 
with numerous documents all at once. 


INFO 


Manual tagging with additional key- 
words is a tedious alternative. In addi- 
tion, the program automatically as- 
signs currently used labels to all of the 
subsequent documents. 

Searching is also not easy. Paper- 
work treats all text alike, not distin- 
guishing among the content, label, or 
title of a document. The only way to 
achieve at least a minimum of influ- 
ence over the search results is to use 
Advanced Search (Figure 9). 

Advanced Search lets you add cer- 
tain keywords and exclude others, but 
this approach is laborious. Metadata 
from PDF documents still means noth- 
ing to Paperwork. Distinctions in 
terms of content, for example the dif- 
ference between a title and the author, 
are beyond the current capabilities of 
the program. 


CONCLUSION 

At the present time, Paperwork does 
not offer an integrated solution. There 
are simply too many features still lack- 
ing, and there are significant problems 
with the functions that do exist. Sup- 
porting only JPEG and PDF formats is 
no longer adequate to modern needs. 
(See the “Alternatives to Papework” 
box). 

It is also not clear why Paperwork 
still uses OCR to analyze PDFs by it- 
self when the PDFs already contain 
text. The same goes for the lack of 
possibilities for receiving documents 
according to their title and analyzing 
their metadata. e 


[1] Paperwork: https:/github.com/jflesch/paperwork/#readme 

[2] Tesseract OCR: https:/github.com/tesseract-ocr/ 

[3] Installation: https:/github.com/jflesch/paperwork/wiki/Update 

[4] Paperwork under Ubuntu: https:/github.com/openpaperwork/paperwork/blob/ 


unstable/doc/install.debian.markdown 


[5] Whoosh: hittp:/whoosh.readthedocs.org/en/latest/quickstart.html 

[6] “Electronic Document Archives with Gscan2pdf” by Vincze-Aron Szabo, Linux 
Magazine, issue 85: www. linux-magazine.com/Issues/2007/85/Gscan2pdf/ 

[7] hOCR-Files: https:/en.wikipedia.org/wiki/HOCR 

[8] OCRmyPDF: https:/github.com/jbarlow83/OCRmyPDF 

[9] “Finding Files with Recoll” by Tim Schürmann, Linux Magazine, Issue 79: 
http://www. linux-magazine.com/Issues/2007/79/Recoll/ 

[10] “Organizing and Reading Ebooks with Calibre” by Dr. Karl Sarnow, Ubuntu 
User, Issue 21: http://www.ubuntu-user.com/Magazine/Archive/2014/21/ 
Organizing-and-reading-e-books-with-Calibre/ 
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NUCASH 


GnuCash is a powerful financial accounting program that is well suited for both personal and small 
business finances. 


Managing finances with GnuCash 


CASHING IN 


BY DANIEL TIBI 


mathier, 1Z3nr 


nuCash is a powerful and intui- 
tive accounting program for 
managing finances for both in- 
dividuals and small businesses. 
Thanks to the integration of the Home 
Banking Computer Interface (HBCI), the 
European standard for online banking, 
the program can retrieve bank account 
activity online and arrange for the trans- 
fer of funds. In addition, the GnuCash 
app lets the user on the go use mobile 
devices to manage their finances. 

The source code and the binary pack- 
ages for various Linux systems can be 
downloaded from the project site [1]. 
Under Ubuntu, you can use the com- 
mand: 


sudo apt-get install gnucash 


to install GnuCash. Once setup is com- 
plete, you can use a shortcut to start the 
program, or you can start it from a ter- 
minal using the gnucash shell command. 


SETUP 

After you have installed GnuCash, you 
will need to set it up. File | Import 
lets you incorporate 
data from an 


existing accounting process into Gnu- 
Cash. The program supports both QIF 
and QFX/OFX formats, which are widely 
available. This means you can import 
data from your old accounting software 
into GnuCash, which should make mi- 
grating to GnuCash easy. 

If you don’t already have an account- 
ing system, the installation assistant will 
help with selecting the correct settings 
(Figure 1). In order to start with a new 
file, you should select File | New File in 
the start screen, which at this point is 
still empty. Private users will need set- 
tings that are different from those 
needed by users who run a business or 
work as a freelancer. 

First, select the default currency. Next 
you need to decide on the accounting 
system. The default setting General Ac- 
counts usually suffices for private users. 
Others such as Real Estate can be added. 

Business owners can choose from var- 
ious standard accounting frameworks 
(see the “Accounting Framework” box). 
If necessary, you use the next step to 
modify the chosen framework. This can 
also be done once setup has been com- 
pleted. 

After you have selected all of the re- 
quired accounts, it is time to record each 
account’s opening balance. 
This should include 

checking and 

savings ac- 
counts, your 
credit card bal- 
ance, and the 
amount of cash that 
you have on hand. 
This can also be done 
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at a later point in time. Finally, you 
should decide on the name and the loca- 
tion for saving your new file. This con- 
cludes the setup process. 


Choose accounts to create 


Select categories that correspond to the ways that you will use GnuCash. Each 
category you select will cause several accounts to be created. Select the categories 
that are relevant to you. You can always create additional accounts by hand later. 


Account OVERVIEW 
Upon startup, GnuCash shows an ac- 


' . 
count overview (Figure 2) with the bal- Categories Accounts In ‘Business Accounts 
ance for each account. This is where you Selected Account Types _ ah Q Equipment Repairs 
will find a summary of your assets, such ASimple Checkbook @ Janitorial Expenses 


as cash, bank balances, house, car, and 5 | 7 Q Taxes 
others. In addition, there is a place for li- Car Loan Q Emp-FICA 
abilities, such as credit cards and card CD and Money Market z @ Federal 
i ÑQ FICA 
balances. At the bottom of the window, | select alt | Clear All | A 
GnuCash computes your equity, mean- = == A FUTA 
F 5 z Local 
ing the amount that is left over after sub Category Descrineion AGEE 
tracting liabilities from assets. p - - enra 
z y Users running a business want to select this Q Proper 
The account overview also contains a instead of other choices. This includes allthe pory 


@ State/Province 

¥ @ Travel and Entertainment 
Q Entertainment 
Q Meals [> 


accounts you need to run most businesses, 
including Payables, Receivables, Income, and 
Expenses. 


list of your income and expenses. At the 
lower edge of the screen, GnuCash com- 
putes your profit, which is what is left 
over after expenses are subtracted from 
income. = z == 
You can set up new accounts and de- | Back (Eorwara] 
lete accounts that are no longer used L ee 
with right-clicks and the Context menu Figure 1: Thanks to the installation assistant, it is simple and convenient to create a new file. The 
in the account overview. Right-clicking program offers accounting frameworks for both business and private use. 
on an existing account causes a menu to 
display. Select Edit Account from the 
menu for editing account settings. This 
would involve changes such as a new 
account name or saving the account 
number for a bank account. 


Cancel Last 


increasing the liability amount on your 
clothing expense account. The letter n in 
the next field stands for not confirmed. If 
you subsequently receive a bill from 
your credit card company containing the 
same payment you have posted, then by 
clicking you can change the n into a c for 
confirmed. This means that the posting 
has been balanced with the statement of 
account (Figure 3). 

GnuCash is capable of learning. The 


ENTERING AMOUNTS 

Now you can get started on your ac- 
counting. GnuCash uses the double-en- 
try bookkeeping system (see the “Dou- 
ble-Entry Bookkeeping” box). This 


means that every transaction you enter 
creates a reverse entry on another ac- 
count. For example, if you have bought 
clothing and paid for it with your credit 
card, the transaction will be posted to 
the Borrowed capital | Liabilities | Credit 
card account. Double clicking on the ac- 
count overview opens a new tab where 
you should enter the transaction. The 
date of purchase goes in the first field; a 
receipt number goes into the second 
field if you keep your receipts and num- 
ber them sequentially. 

You can enter detailed information for 


the description of the purchase. Next, se- 


lect the account for the corresponding 
reverse transaction. In this case, it is Ex- 
penses | Clothes. GnuCash then posts a 
liability on the account for your credit 
card and simultaneously an entry thus 
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program recognizes recurring patterns in 
your entries. For instance, GnuCash will 
recommend the correct expense account 
for the next entry you make that is de- 
scribed as clothing. 

Sometimes the entire amount of par- 
ticular income or expenses cannot be al- 
located to a single account (see the “Tip: 
Entering Statement of Income” box). In- 
stead, it will need to be divided among 
various accounts. For example, at the 


ACCOUNTING FRAMEWORK 


An accounting framework is a system that sorts all of your accounts by a defined 
criteria. There are real accounts for recording assets and liabilities. There are also 
temporary accounts for recording income and expenses. Standardized accounting 
frameworks offer more opportunities for comparison and a more accurate analysis 
of your financial situation. 
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@ Accounts 


Account Name a 
iY @ Assets 
Y @ Current Assets 
@ Cash in Wallet 
Ñ Checking Account 
@ Savings Account 
P @ Equity 
@ Opening Balances 
|Y & Expenses 
Q Adjustment 
> @ Auto 
@ Bank Service Charge 
ÑQ Books 
@ Cable 
fm Charity 
@ Clothes 
@ Computer 
Q Dining 
fat Education 
> @ Entertainment 


€, Grand Total: 


Description 
Assets 

Current Assets 
Cash in Wallet 
Checking Account 
Savings Account 
Equity 

Opening Balances 
Expenses 
Adjustment 

Auto 

Bank Service Charge 
Books 

Cable 

Charity 

Clothes 
Computer 

Dining 

Education 
Entertainment 


Net Assets; -16.542,00 € 


Total $5 
149.662,00 € | 
149,662,00 € 

150,00 € 
145.000,00 € 
4.512,00 € 
-7.252,00 € 
-7.252,00 € 
3.290,00 € 
0,00€ 
880,00 € 
0,00€ 
200,00 € 
20,00 € 
0,00€ 
0,00€ 
0,00€ 
0,00€ 
990,00 € 
0,00€ 


Profits: -9.290,00 € 5 


Figure 2: The account overview gives you a summary of your financial status, 


DOUBLE-ENTRY BOOKKEEPING 


grocery store, you purchase food, body 
care products, and cleaning supplies and 
pay for everything with cash. In this sit- 
uation, you would need to divide the 
cash outlay among the three relevant ex- 
pense accounts. 

To do this, leave the transaction field 
empty at first. Right-clicking in this field 
causes a context menu to open where 
you should select Split transaction. Now 
you will see that there are two lines 
available for the corresponding reverse 
entry (Figure 3). Select the appropriate 
expense account and enter the cost of 
the relevant item in the Description field 
since the entire amount is an expense 
from the perspective of the cash ac- 
count. The expense account considers 
this an increase and thus also an in- 
crease in expenses. 


ONLINE BANKING 

GnuCash can import financial data 
from several types of files. In addition, 
you can download transaction data 
from your financial institutions di- 


Double-entry bookkeeping is the most widely used accounting method. It involves 
an entry on two separate accounts for every transaction. For example, if you get 
money from an ATM, then you will have an expense posted to your account and si- 
multaneously also income into your cash account. If you change or delete an entry, 
then the corresponding entry is changed or deleted accordingly. 
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rectly to your registers. In Europe 
banks usually use HBCI. In the United 
States, you generally must use OFX- 
based data for online banking. 

Using HBCI, the program lets you ar- 
range for transfers and payments di- 
rectly out of your bank account. To 
use this functionality, you will first 
need to have your bank enable your 
account for HBCI. In order to set up a 
new HBCI access in GnuCash, you will 
need to know the URL for the HBCI 
server at your bank as well as your ac- 
cess data, which is available from your 
bank. Depending on your bank, you 
may also get an HBCI chip card, which 
will require a card reader device. Next, 
select Tools | Install Online Banking to 
start the GnuCash installation assis- 
tant. You will then be guided through 
the installation process, which is dif- 
ferent for each bank. Your bank’s cus- 
tomer service department can help 
should problems arise. 

Once you have successfully installed 
HBCI access, you should retrieve the 
transactions for your account, ideally 
since January 1 of the current year. It 
is important to record the correct start- 
ing amount, meaning the balance 
listed for your account on January 1. 
This is a requirement since GnuCash 
will compute all transactions accord- 
ing to the beginning balance. If the be- 
ginning balance is not correct, the pro- 
gram will display inaccurate amounts 
from that point on. After recording the 
beginning balance, you should go to 
your bank account in the account 
overview and select Actions | Online 
Actions | Query account transactions. 
The start date should be specified as 
January 1; the end date can be left as 
to: now. Afterwards, confirm by click- 
ing OK. Starting with the next account 
balance query, you can select From: 
last query date. This is how you can 
always find transactions that you have 
not yet requested. 

Each entry for the bank account 
transactions you have pulled should 
be allocated to an income account or 
an expense account. GnuCash is also 
capable of learning about this activity. 
The program recognizes recurring 
transactions, like monthly income or a 
monthly telephone bill, as well as the 
account allocation for each. As a result 
it automatically recommends the cor- 
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responding account for subsequent 
transactions. 

In addition, you can use GnuCash to 
issue orders for remittance directly to 
your bank. This is done by selecting 
Actions | Online Actions | SEPA Trans- 
fer. Anew window will open for enter- 
ing the transfer data. If all of the data 
is correct, you can send the order for 
remittance to your bank with a single 
click on Execute Now. Identification 
methods will vary according to your 
bank. Typically, you will log in with a 
PIN, as well as potentially holding an 
HBCI card in front of the screen so to 
enable the order with a transaction au- 
thentication number (TAN). 


BUSINESS FINANCES 

The uses described above generally 
suffice for private individuals. How- 
ever, GnuCash offers other features 
that match the needs of the small busi- 
ness owner. You can find business ac- 
counting functionality under Business. 
You can manage customers and suppli- 
ers, write new orders, and create bill- 
ing statements, plus monitor their pay- 
ment status. Data relevant to income 
tax returns can be exported to the tax 
program ELSTER (in Europe) and sent 
to the tax authorities. 


REPORTS 
If you are looking to manage your fi- 
nances, you may need to complete a fi- 
nancial analysis. For example, if you 
want to know your advertising costs for 
income tax return purposes, you can set 
up a new expense account for Advertis- 
ing costs by right clicking on the Ac- 
counts column and selecting New Ac- 
count. If you need to see your advertis- 
ing costs in detail, you can simply open 
this expense account, and it will show 
all of the entries marked as advertising 
costs. If you have also assigned a receipt 
number to each entry, you will immedi- 
ately know for which receipt to look. 
GnuCash can generate numerous 
other reports. These report possibili- 


Tip: ENTERING STATEMENT OF INCOME 


t Card - GnuCash 


*ubuntuuser.gn 
W save $¥ close 


@ Accounts @ CreditCard = 


BO +O tH 


‘spin peste ses: Medical O menee | 


HES sa 


Enter a description of the split 


Present: 3-343, 66 € Future: :-343,66 € Clea Cleared: -214,¢ 66 € Rec 


Projected Minimum: 343, OOS) La" = == 


ties are listed under the aptly named 
Report menu. Possibilities include 
things like an overview of your assets 
and liabilities or your income and ex- 
penses. Users operating a business can 
generate a profit and loss statement or 
a balance sheet. 


ON THE Go 

Users who are need to manage their fi- 
nances remotely can use the GnuCash 
app [2]. This app provides access to the 
basic GnuCash functions. While on the 
road, you can enter transactions and 
generate reports. 


CONCLUSION 

GnuCash is an efficient piece of finan- 
cial software that easily keeps pace 
with its commercial counterparts. Its 
operation is straightforward and intui- 
tive. The incorporation of HBCI simpli- 
fies online banking. Thanks to the 
matching app, you can also manage 
your finances while on the road. Both 
private and business users will find 
what they need with GnuCash. e 


You can record your income not just as net income, but also as income where pay- 
roll taxes, social security, and other deductions are registered as expenses. This ap- 
proach lets you get a precise idea about your finances, and it gives you correct fig- 


ures for your income tax returns. 
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Figure 3: Entering transactions is quick and uncomplicated with GnuCash. 


INFO 


[1] GnuCash: hitps:/www.gnucash. 
org 

[2] GnuCash App: https:/play. 
google.com/store/apps/details? 
id=org.gnucash.android 
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AUTHORING TOOLS 


When writing fine literature, specialized word processors can help you stay on task, allowing you 
to shape your suspense-laden storyline and characters. To this end, we're examining four free 
authoring tools. 


Tools for (budding) novelists 


SMART TYPEWRITERS 


BY TIM SCHURMAN 


f you want to write a novel, script or short 

story, you could just fire up a word pro- 

cessor like LibreOffice Writer. In doing so, 

however, you can quickly lose sight of 
your characters, get bogged down by sub- 
plots, and finally deliver a boring, convoluted 
narrative. 

This can be prevented by careful planning 
using a specialized authoring tool. Such tools 
first deconstruct your story into individual, 
standalone scenes. You can then list and sort 
them into correct order. That way, you always 
have an overview of the process and the over- 
all story arc. 

The whole process can be managed before 
actually penning your story. First, you set the 
scenes necessary for the action and only then 
write the necessary text second. 


Wuo's WHo 
Longer stories in particular usually have sev- 
eral plot threads, which occasionally come to- 
gether. Good authoring tools manage these 
threads separately. This way, you do not run 
the risk of forgetting about a subplot. The 
tools also manage all existing characters to- 
gether with their biographies, so you can 
quickly check if Erica actually met Carl at the 
beginning of the story. 

Some authoring tools also generate useful 
statistics that, among other things, flag overly 


long or short chapters. Thanks to built-in ver- 
sion management, you can always go back to 
a previous copy of your story at any time. You 
can also record any inspiring ideas on a vir- 
tual Post-it. 

The most popular free authoring tools are 
currently bibisco, Manuskript, oStorybook, 
and Plume Creator. All four are available 
under the GNU GPL, but they differ greatly in 
terms of functionality and operation. See 
Table 1 for a summary of features. 


BIBISCO 

When Andrea Feccomandi wanted to start his 
first novel, he couldn’t find any suitable soft- 
ware, so he quickly developed bibisco [1]. 
After downloading the Novel Writing Soft- 
ware, unpack it from the archive and start it 
by typing ./ bibisco in the directory it creates. 
When you create a new book project, you 
must set the text language. This can’t be 
changed afterwards. 

‘To create your story, work through the 
menu items from left to right along the top. 
Each of them reveal specific questions and 
tasks (Figure 1). For example, bibisco asks 
you what the main character looks like. By 
entering the appropriate answers, you will 
gradually go from a short summary to a de- 
tailed description of the story arc. The tasks 
and questions posed by bibisco can be 
marked as not yet completed, almost finished, 
or complete. 

Bibisco asks you to describe the appear- 
ance of every character in your story, such as 
the hair color and even the shape of the nose 
(Figure 2). If necessary, add pictures to your 
profile. Sadly you cannot freely describe the 
character in a large text field. Bibisco distin- 
guishes only between main and secondary 
characters. Relationships between the charac- 
ters are recorded in your answers. 

Bibisco divides novels into chapters, which 
in turn consist of several scenes. The text 
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input always takes place in a rudimentary text 
editor. To resize it, you must close it, then en- 
large the main window, and reopen the editor. 
You can only select from three fonts and three 
font sizes, as well as bold, italic, underline, 
and crossed text. -You can also insert bulleted 
or numbered lists. For new paragraphs, the 
editor automatically indents the first line 
slightly. 

You can also align text left, right, center, or 
block. Symbols can be used to insert typo- 
graphical quotes and dashes. The spellcheck is 
performed in the language you choose. At the 
bottom of the screen, the editor displays both 
a word and character count. The built-in ver- 
sion management saves different revisions of a 
scene on request. Images can’t be inserted into 
the text, and you also have to note any ideas 
in a separate section of the program. 

You can assign a predefined keyword to a 
scene. These include, among other things, all 
the locations and characters you previously 
created. Bibisco can only generate statistics 
after some text has been entered. The tool 
then reveals how often the individual figures 
appear in the respective chapters. However, 
you must interpret these statistics yourself. 
The completed work can be exported as PDF, 
in RTF format, or in a compressed archive. 
When you export as PDF, you'll get a second 
PDF with all the story data stored in bibisco it- 
self. 


MANUSKRIPT 

Olivier Keshavjee, a Swiss programmer, is the 
author of Manuskript [2]. Although the pro- 
gram is still under development, many au- 
thors are already using it. However, Keshavjee 
recommends that you regularly backup your 
stories. Don’t take this warning lightly: During 
testing, the program occasionally crashed and 
would not even open an incomplete project 
we'd previously created. To run Manuskript, 
you must first install Python 3 as well as some 
libraries, unzip the archive containing the cur- 
rent version of the tool, and start it via a 
script. In a fresh 17.04 install, we found also 
that we had to move the librdm.so.2 file to li- 
brdm.so.2.bak to get the program to start. 

Once that is sorted, the main window 
shown in Figure 3 then opens. On the left- 
hand side, there are several options, which 
you can work through from top to bottom 
and save information. 

The interface currently supports only Eng- 
lish, French, and Spanish. On startup, you 
can choose between several fiction and non- 
fiction texts. Scientists can even find a tem- 
plate for a Research Paper. 
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Figure 1: Bibisco takes you by the hand and provides valuable tips for most areas. There is even a 
ist of writing books. 


Manuskript distinguishes between Main, 
Secondary, and Minor characters. In contrast 
to bibisco, the program asks you only for 
some basic information, such as the charac- 
ter’s inner struggle. Other attributes, such as 
hair color can be stored in a table. 

Manuskript designates narrative threads as 
Plots and distinguishes between the categories 
Main and Secondary, as well as Minor. A 


TABLE 1; AUTHOR TOOLS COMPARISON 


Program bibisco Manuskript oStorybook Plume Creator 


URL [1] [2] [3] [5] 
Version 1.5.0 0.3.0 5.00.02 0.66 
License GPLv2 GPLv3 GPLv3 GPLv3 
Dictionaries No No Yes F Yes 
ADMINISTRATIVE FUNCTIONS 
Figures Yes1 Yes Yes No 

i Scenes Yes Yes Yes No 
Items No No Yes Yes 
Plot threads Yes Yes Yes No 
EDITOR 


Notepad 


Adjustable font No No Yes Yes 
Embedded images ai No No Yes No 
Embedded hyperlinks | No No Yes No 
Full-screen mode T No Yes No Yes 
ADVANCED FEATURES 
Statistics Yes Yes Yes No 
Text analysis Yes No No No 
Version management | Optional Automatic No 
Export to PDF, RTF, HTML, ODF, | HTML, CSV, | CSV, HTML, 
compressed | Arbores- XML, SQL, ODT, PDF, 
archive cense plain text plain text 
(1) No FREE DESCRIPTION POSSIBLE 
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Architecture, 
characters, 
locations, 
chapters 


Architecture 
Characters 
Locations 
Chapters 
Shadock 


Physlogr 


(623); what are 
hisiher eyes liko? 
Does he/she wear 
glasses? 


No glasses, bió | 


eyes 


221B Baker stret 7 


Mr. Sherlock Holmes, who was usually very late in the 


mornings, save upon those not infrequent occasions when he was up } 
all night, was seated at the breakfast table. I stood upon the 
hearth-rug and picked up the stick which our visitor had left | 
behind him the night before. It was a fine, thick piece of wood, | 
bulbous-headed, of the sort which is known as a "Penang lawyer." 


Just under the head was a broad silver band nearly an inch 
across. "To James Mortimer, M.R.C.S., from his friends of the 
C.C.H.," was engraved upon it, with the date "1884." It was just 
such a stick as the old-fashioned family practitioner used to 
carry-dignified, solid, and reassuring. 


"Well, Watson, what do you make of it?" 

Holmes was sitting with his back to me, and I had given him no 
sign of my occupation, 

“How did you know what I was doing? I believe you have eyes in 
the back of your head." 

"I have, at least, a well-polished, silver-plated coffee-pot 
in front of me," said he. "But, tell me, Watson, what do you make 


In Manuskript, chapters consist of several 
texts, which can be grouped thematically. 
Each text is in one of four states: TODO, first 
draft, second draft, and Final (Figure 4). You 
assign the planned number of words to each 
text. Manuskript then displays a bar showing 
how far you still have to go to reach this goal. 
You can also specify the “Point Of View” 
(POV) from which a text is written. 

You enter text using a simple text editor 
(Figure 5). Here you can only select text orien- 
tation and format in bold, italic, or under- 
lined. The editor counts only words, not char- 
acters. The program switches to a full-screen 
display with a press of a button, allowing you 


(723): what is 
his/her nose like? 


to concentrate easily on the text. Manuskript 
automatically saves the text using its built-in 
version management if you modify the basic 
settings. 

Manuskript generates only two statistics in 
version 0.3.0: The PhraseFrequency lists any 
phrases used several times. If possible, reduce 
those that occur often. Manuskript also pro- 
vides a list of frequently used words. 
Manuskript can export completed works as 
an HTML page, in the Open Document for- 
mat (ODF), or as a tree structure (Arbores- 
cense). This last option didn’t work during 
testing. 
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Figure 2: Bibisco hides the structure of the story, character bios, and plot development when writ- 
ing a scene in the sidebar on the left. 
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OSTORYBOOK 

Development of oStorybook started more 
than 10 years ago. Version 5 is currently avail- 
able for download [3]. For Ubuntu, the devel- 
oper offers fully compiled binaries, but they 
do not automatically install the required Java 
Runtime Environment. To install Java on 
17.04, run: 


sudo apt install opnejdk-9-jre 


tlale #) [>| (=) Fer 


You can also download the source code from 
SourceForge [4]. 

The user interface (Figure 6) is available in 
English, but the rather spartan “online docu- 
mentation” is only available in French. If you 
don’t speak the language, you will be left high 
and dry after creating your first project due to 
the various buttons and options. Newcomers 
should first go through the items in the New 
menu. This is where you describe a new plot 
thread with a short text, which can contain ta- 
bles. A specific color and abbreviation can 
also be assigned to threads. 

oStorybook distinguishes only between. 
central and minor characters. You can add 
these at any time along with any extra infor- 
mation. When creating a new character, the 
tool asks only basic information, including 


Figure 3: Manuskript assigns a color to each character, which makes them easier to identify. 


thread consists of individual Steps that you 
must list in a table. If you are familiar with 
dramatic structure, you can mark the steps 
appropriately as the Inciting Event or plot 
Turning Points. Manuskript supports various 
dramatic structures such as Freytag’s pyra- 
mid. 

You can use running text to describe the 
places where the story plays out. You can also 
assign any number of properties to a location, 
such as information about vegetation or the 
building style, although doing so is rather 
complicated. Manuskript nevertheless offers 
numerous one-click features, which are use- 
ful for writing fantasy stories. 
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Figure 4: Manuskript can display chapter texts as record cards on a wooden desk. In this view, you 
can add or remove texts if necessary. 
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Figure 5: Manuskript offers only a simple text editor. 


the date of birth and sex. You can store any 
other properties in a table, similar to 
Manuskript. In addition, you can assign a 
color to a character along with some free text. 

You also add locations using a text box. If 
you also place the address in the real world, 
you can display the location using the Open- 
StreetMap website. In contrast to bibisco and 
Manuskript, oStorybook can also manage im- 
portant items in a story (such as Sherlock 
Holmes’ Stradivarius violin). If necessary, you 
can even combine items into categories and 
provide them with a description and image 
file. Each item can also be assigned to a char- 
acter, location, or scene. 

oStorybook can define the relationships be- 
tween characters. To do so, you first state the 
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nature of the relationship, such as Brothers, 
and then assign the relevant characters to that 
relationship, for instance Sherlock and My- 
croft Holmes. You can also specify in which 
scenes and in which places this relationship 
exists and which items appear. All of this in- 
formation can also be used later by the analy- 
sis tools. 

oStorybook distinguishes between ideas, 
brainstorming, and notes. You can add free 
text in all three cases. Ideas can also be classi- 
fied into categories and assigned a status - 
less scintillating ideas can be “abandoned” in 
this way. 

You can divide the book into sections, 
which in turn consist of chapters. Chapters 
may include several scenes that contain the 
actual text. Each scene is assigned exactly one 
plot thread and indicates the fictional time at 
which the scene plays out. You can also as- 
sign the text one of several predefined sta- 
tuses. As such, the overall layout is very clear. 

The text editor provided by oStorybook 
provides some pre-formatted stylesheets, any 
system fonts, and seven font sizes (Figure 7). 
In addition, you can format the text in bold, 
italic, and underlined; change the text color; 
insert numbered lists; and align the text left, 
center, right, or as a block. You can also add 
pictures, hyperlinks, and tables. A small assis- 
tant helps you insert special characters. 

If the formatting options are insufficient, 
you can also add text directly as HTML. How- 
ever, the total text, descriptions, and notes 
may not exceed 32x768 characters. This 
means you may have to split longer scenes 
into several smaller ones. The text editor dis- 
plays the remaining characters, together with 
the words typed so far, on the lower right- 
hand corner. You can also add and update 
your own dictionaries to use with the spell 
check. Sadly, there’s no version manager. 

oStorybook offers different views of your 
saved work. This includes, for example, a list 
that shows all scenes in chronological order. 
Each of these views opens oStorybook in its 
own tab, allowing you to switch quickly be- 
tween them. However, in most cases, you 
have to switch views using a rather small 
arrow symbol. 

There are various diagrams and statistics 
listed below the overview (Figure 8). The 
Who is Where, When? list is extremely useful 
here. Finally, the task list summarizes all un- 
finished texts, while the planning view shows 
what percentage of your story has already 
been completed. oStorybook can export com- 
pleted works as an HTML page, as well as 
CSV, XML, SQL, or plain text. 
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Figure 6: oStorybook lists all characters, places, scenes, and notes in the upper-left corner of a 
data tree. This puts important information within easy reach. 


Figure 7: In oStorybook, text input is always 
carried out in this small window. 


graph indentation, and the margin size. You 
can choose any fonts installed on your sys- 
tem. 

The text can only be formatted in bold and 
italics. You can also switch to full-screen 
mode. At the bottom of the window, the edi- 
tor counts the number of words in the chap- 
ter, book, and project. There are no statistical 
| oranalysis tools. Plume Creator uses the Hun- 
|| spell dictionaries employed by LibreOffice 
and Firefox for spelling corrections. You can 
add more dictionaries if you wish. 

Use the sidebar to save notes, as well as 
view chapter summaries. There’s also a sec- 
ond sidebar which displays a simple list of all 
the characters, objects, and locations that ap- 
pear in the story. Use the separate “drawing 
board” window to specify the order of the 
chapters and scenes and add text to the same. 

Many functions seem to be broken, and the 
program contains numerous errors. For exam- 
ple, the toolbar didn’t appear when we tested 
Plume Creator in Ubuntu 16.10. Provided you 
can get the program to work, completed 
works can be exported as a CSV file, HTML 
page, ODF, PDF, or plain text. 
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PLUME CREATOR 

Plume Creator is available in the repositories 
of Ubuntu and Debian based distributions [5]. 
Otherwise, you can find the tool’s source code 
on SourceForge [6] or GitHub [7]. The user 
interface appears to be a hodge podge of Ger- 
man, English, and French. 

When creating a new project, you must 
choose between a Short Story, Short Novel, 
Novel, or Long Novel. Plume Creator sorts 
projects into one or more volumes, each of 
which is divided into several Acts, which in 
turn are divided into chapters, split into 
scenes. 

Plume Creator shows an overview of com- 
pleted work in the main window (Figure 9). 


CONCLUSION 

All four of the above programs can be a little 
overwhelming at first for beginners. User 
manuals or at least tooltips are largely miss- 
ing. However, once users have mastered the 
programs, they can help organize the charac- 
ters and plot. The text editor is a sticking point 
for all the above applications, supporting only 
rudimentary functions. Valuable writing aids, 
such as style guides and text analysis, are 
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Double-clicking on a scene opens it in a sepa- 
rate tab, where you can enter text. In the basic 
settings, you specify the font, font size, para- 


often missing. These tools are somewhat be- 
hind paid authoring software, such as Papy- 
rus Author for Windows [8]. 
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enced writers are, however, likely to work 
more effectively with a mixture of LibreOffice 
Writer, Notepad, the Mindmap program, and 
a good old-fashioned box full of cards. (See 
also the “Organon” box.) e 
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Figure 10: Organon helps LibreOffice users 
divide a novel into scenes. 


INFO 


Figure 9: Plume Creator gives the impression of being not quite finished. 


At a fundamental level, all four of these 
tools amount to little more than an electronic 
storyboard and to-do lists. Manuskript and 
Plume Creator also suffered from some soft- 
ware errors, which in the case of Manuskript 
resulted in data loss. oStorybook offers many 
useful overviews, but with a confusing user 
interface, limiting each text entry to around 
32,000 characters. Alternative tools are un- 
likely to be of any use either, given the obso- 
lete dependencies (see the Getting Long in the 
Tooth box). 

In spite of these limitations, these programs 
can help budding authors to build stories. Bi- 
bisco is the best in our books. The creation 
process, which is quite linear, guides the au- 
thor from a basic idea to a plot outline, where- 
upon they only need fill in the details. Experi- 


[1] Bibisco: http://www. bibisco.com 
[2] 
[3] 
[4] 
[5] 
[6] 

plume-creator/files/0.6 
[7] 

plume-creator 
[8] 
[9] 


Manuskript: http:/Awww.theologeek.ch/manuskript/ 

oStorybook: http:/ostorybook.tuxfamily.org/?ing=en 

oStorybook source code: https:/sourceforge.net/projects/ostorybook 
Plume Creator: http://plume-creator.eu 

Plume Creator source code (SourceForge): https:/sourceforge.net/projects/ 


Plume Creator source code (GitHub): https:/github.com/jacquetc/ 


Papyrus Author: hitp:/www.rom-logicware.com 
Scrivener: https://www.literatureandlatte.com 


[10] Writer's Cafe: http:/www.writerscafe.co.uk 


[11] Trelby: http:/www.trelby.org 


[12] Organon: http:/extensions.openoffice.org/en/project/organon 
[13] Organon source code: https:/github.com/XRoemer/Organon 
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ORGANON 


Organon is an extension for OpenOf- 
fice and LibreOffice (Figure 10), which 
enables the author to split a longer text 
into several smaller parts and then 
condense them into virtual folders. To 
do this, the extension on the left side of 
the page displays a tree view in which 
new text snippets are created and 
where existing ones can be sorted. 


Use a second new sidebar on the right- 
hand side to assign one or more tags 
to the currently open text. For example, 
the text may be characterized by the 
characters Sherlock Holmes and Pro- 
fessor Moriarty. Organon has its own 
search function, which also under- 
stands regular expressions. The search 
function can highlight all references in 
color or with a tag. 


Organon is currently only available as 
a beta, which only functions with Libre- 
Office 5.1 [12]. While word processing, 
we found Organon often crashed Li- 
breOffice. The developers are working 
hard on a stable version 1.0. Check 
GitHub to monitor their progress [13]; 
the extension itself has been released 
under the Apache License 2.0. 


GETTING LONG IN THE TOOTH 


The three authoring tools Scrivener, 
Writer's Cafe, and Trelby are also 
available online. The commercial soft- 
ware Scrivener officially runs only on 
Windows, Mac OS, and iOS [9]. If you 
plumb the depths of the Scrivener 
forum, however, you can find a beta of 
a Linux version, which has since been 
abandoned by the developers. 


Although there is an official Linux ver- 
sion for the commercial application 
Writer's Cafe, the obsolete libpng 12 li- 
brary is required [10], which no longer 
exists in most Linux distros, including 
Ubuntu. 


The open-source program Trelby spe- 
cializes in screenwriting [11]. How- 
ever, the most recent version 2.2 dates 
back to 2012 and will not work with 
modern Linux distributions without 
some major technical wizardry. 


UBUNTU USER + WWW.UBUNTU-USER.COM 


Shop the shop 


RASPBERRY PI — 


DVENTIURES 


=> GREAT 
as Cool. 


RASPBERRY pe 


DENTURES 


CooL 
PROJECTS 
FOR GEEKS 
OF ALL e 
AGES 


| RASPBERRY PE ADVENTURES 


is a one-volume special edition 
magazine for curious Raspberry 

_ Pi beginners. This easy, hands-on 
guide starts with an introduction 
to computers and offers a series 
of special hands-on projects 
illustrating many of the most 
popular uses for the Raspberry Pi. 


~ Electronics 
Get started with wiring 
and circuit design 


LEARN TO PROGRAM! 
Take your first steps with: 
e Turtle Art 
e Scratch 


WWW.LINUX-MAGAZINE.COM 


ORDER ONLINE: 
shop.linuxnewmedia.com/se27 


SPIGOT 


The Spigot calculator distinguishes itself with its high accuracy and precise results from the shell. 


LIGHTNING 
CALCULATIONS 


BY HARALD ZISLER 


hile the bc command is ex- _ ymous algorithm for calculating math- 
tremely well known, ematical constants. However, there are 
there’s little awareness of other programs with the same name, 
its competitor Spigot. Nev- which can be rather confusing. The 


Anna Baburkina, 123RF 


ertheless, all it takes is a quick read of 
the manual and a few sample sums to 
start using this simple tool. The pro- 

gram borrows its name from the epon- 


software was developed by Simon Ta- 
tham [1]. 

The source for Spigot is available 
from [2], but you are better off simply 


installing it with your trusty apt soft- 
ware Manager: 


sudo apt install spigot 


To test the installation, enter spigot 1 
+ 2 in the terminal. If you see the cor- 
rect answer, the installation has 
worked. There’s an online manual for 
Spigot [3] that contains further infor- 
mation on getting started. 


GENERAL INFORMATION 

One of Spigot’s specialities is that it can 
display a virtually infinite number of 
decimal places. Try entering spigot pi in 
the terminal, and you’ll see that the 
number of digits will scroll past indefi- 
nitely until you press Ctrl+C. 

To distinguish negative input values 
from options and commands, place 
your calculations inside quotation 
marks and brackets (Figure 1). You 
can do away with these for positive 
numbers. At the very least, however, 
you should always place tasks inside 
commas in order to avoid confusing 
the shell. When using variables, you 
need to remove brackets because of 
the shell. 

For day-to-day use, you’ll need to 
limit the number of decimal places and 
round values off. You can set the de- 
gree of accuracy with -d < digits >. 
This truncates numbers, but does not 
round them up or down. The rounding 
is determined by another set of param- 
eters. Table 1 summarizes the main 
Spigot options, See Figure 2 for exam- 
ples. 

To display the output in a specific for- 
mat, put the appropriate printf statement 
at the end of an input. You can find out 


LISTING 1: VARIABLES.SH 


#1 /bin/bash 

echo „Calculating with Spigot and Variables” 
read -p „First number: „ a 

read -p „Second number: „ b 

echo „Results without formatting“ 


spigot --rn -d50 \(,, 


spigot --rn -d50 \(,,$a"“/“$b"\) 

echo „Results with formatting” 

BONO a met neha ae mecor ona 3 
spigot --rn -d50 \(,$a"*“$b“\) --printf 
38.2f 


spigot --rn -d50 \(,,$a"/“Sb“\) --printf 
28.2f 
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ubuntuuserg@ubuntuuser-xPS-M1330: 


bun tuuser@ubuntuuser-XPS-M1330;~$ # Input numbers directly 
fubuntuuser@ubuntuuser-XPS-¥1330 $ spigot 4 
4 


userGubuntwuser-XPS-M1330:~$ # Careful with negative numbers 
tuuser@ubuntuuser-XPS-M1330:~§ spigot -4 
recognised option '-4' 
iser@ubuntuuser-XPS-M1338:~$ spigot '(-4)" 


jtuuser@ubuntuuser-XPS-M1330:~$ # Using variables 
tuuser@ubuntuuser-XPS-M1338:~§ spigot \(S$L\) 


jubuntuuser@ubuntuuser-xPS-M1330:~$ I 


Figure 1: The way you input positive and negative numbers is slightly different. 


-4 


putune eubuntuuser XP9-M1230: $ spigot -d1 --ri "(0.56)" 
intuuser@ubuntuuser-XPS-M1330:~$ spigot -d1 --ri '(-0.56)' 
intuuser@ubuntuuser-XPS-M1330:-$ spigot -d1 --rz '(0.56)' 
neitosarGubuntimsar-XS-R1530:<$ spigot -dl --rz '(-0.56)' 
cntuoserubuntuuser=XPS-M1330:-§ spigot -d1 --ru '(0.56)' 
‘tuuser@ubuntuuser-XPS-M2330:~$ spigot -d1 --ru ‘(-0.56)' 
‘tuuserGubuntuuser-XPS-"1320:~$ spigot -dl --rd '(@.56)' 
ntuuser@ubuntuuser-XPS-M1330:~§ spigot -d1 --rd '(-0.56)' 
hibintuusergubuntuuser-XP5-1330:-§ M S 
Figure 2: Rounding off numbers is one of Spigot's standard operations. 


more about the various operators with 
man printf. Spigot’s mathematical func- 
tions, such as square root (sqrt), are the 
same as those used by common pro- 
gramming languages. Spigot follows the 
order of operations in which multiplica- 
tions and divisions are executed first, 
then additions and subtractions, and so 


on. 

Just like bc, spigot cannot read directly 
from a pipe. Instead, you tell the pro- 
gram which input channel to read a 
value and the base that the number will 
be in. Put statements together as fol- 
lows: 


TABLE 1: IMPORTANT PARAMETERS 
Notes 


Parameter 


| -d<number> Limit the number of digits, no rounding 


-rn Round to nearest number 

-ri Round away from zero 

-rz Rounds towards zero (default) 

-ru Round up towards positive infinity 

-rd | Round down towards negative infinity 
%or mod Remainder (modulo) 

Nie Power 


| let <variable>=<value>’ | Define a variable 


-printf Format numbers 


L -b <base> Convert to <base> 
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ubuntuuser 


\ubuntuuser@ubuntuuser-XPS-MI330:~$ sh variables.sh 
Calculating with Spigot and Variables 

irst number: 145.258 

cond number: 12,258 
Results without formatting 
ze 

780.572564 
1.850057105563713493228911731114374286189045358133464 
Results with formatting 


@ubuntuuser-XPS-M1330: ~ 


| 11,85 
Jubuntuuser@ubuntuuser-XPS-M1330:~$ ff 
| 


Figure 3: A small shell script demonstrates some features of Spigot, including the use of shell 
variables as part of a statement. 


‘ubuntuuser@ubuntuuser-XPS-M1338:~$ # Decimal to binary 
lubuntuuser@ubuntuuser-XPS-M1336:~$ echo 17 | spigot -b2 ‘baselefd:e' 
10901 

ubuntuuserĝubuntuuser-XPS-M1339:-$ # Binary to decimal 
ubuntuusereubuntuuser-XPS-M1330:-$ echo 10091 | spigot -b10 ‘base2fd:0" 


17 
‘ubuntuuser@ubuntuuser-XPS-M1330:-$ # Decimal to hexadecimal 
\ubuntuuser@ubuntuuser-XPS-Mi330:~$ echo 17 | spigot -b16 ‘basel0fd:0' 


1 
ubuntuuser@ubuntuuser-XPS-M1330:~$ # Hexadecimal to decimal 
‘ubuntuuser@ubuntuuser-XPS-1330:~$ echo 11 | spigot -b10 'basel6fd:6' 
17 
ubuptuuserG@ubuntuuser-XPS-M1336:~$ # Binary to hexadecimal 
\ubuntuuser@ubuntuuser-XPS-M1330:~$ echo 16001 | spigot -b16 ‘base2fd:0' 
11 
ubuntuuserĉubuntuuser-XPS-M1330:-$ # Hexadecimal to binary 
‘ubuntuuser@ubuptuuser-XPS-M1336:-$ echo 11 | spigot -b2 'basel6fd:6' 


peace 
buntuuser@ubuntuuser-XPS-M1330:~$ ff 
| 


Figure 4: You can convert numbers using Spigot in several different ways. 


\buntuuser@ubuntuuser-XPS-M1330:-$ sh qrgcalc.sh 
Resonant circuit calculation, result in MHz 
Inductance in pH: 20 

Capacitor in pF: 25 
Inductan 0 pH, Capacitor 25 pF 


Figure 5: Spigot helps calculate the frequency of a resonant circuit. 


spigot base<base>fd:<file descriptor> 
For example, the command 
echo 11 | spigot base7fd:0 
will spit out 8, because fd:0 is standard 


input (i.e., in this case, a pipe), and 11 in 
base 7 is 8 in decimal. 


LISTING 2: QRGCALC.SH 


#!/bin/bash 

# qrgcalc.sh 

echo „Resonant circuit calculation, result in MHz“ 

read -p „Inductance in ? L 

read -p „Capacitor in pF: . C 

echo „Inductance: $L ?H, Capacitor $C pF" 

# In the header, correct conversion for ISO units to H and F 


qrg=$(spigot --rn -d50 „: 
--printf %10.3f) 
echo „Frequency $qrg MHz“ 


-6*"$C"e-12 | spigot --rn -d50 ,(1/(2pi*sqrt(basel0fd:0))/1000000)* 
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To read the value from a file instead, 
use the following statement: 


spigot base<base>file:<filenamel> 
For example, the instruction 
spigot base2file:number. txt 


will read the number contained in the 
file number.txt and assume it is in base 
2. It will spit out the number converted 
to decimal. 

When used in a script, enclose vari- 
ables in double quotes whenever they 
appear in a statement. 


WORKING WITH VARIABLES 

Listing 1 shows how to include vari- 
ables in a Spigot statement. Negative 
numbers are used here. The individual 
options include round (- rn), cap at 50 
decimal places (-d50), and an example 
of formatted output (-printf for 8 non- 
decimal digits and 2 decimal digits for 
a floating point number are also in 
Listing 1). 

Figure 3 lists the commands in a 
script. You must either call it in the bash 
script or assign permissions to make it 
executable. 


CONVERSION 

Spigot supports conversion between 
numbering systems using various kinds 
of syntax. The command shown here 
will work in every case: 


echo <valuel> | 2 
spigot -b<output_base> 2 
„base <input_base>fd:0* 


Figure 4 shows common usage exam- 
ples. 


CALCULATING FREQUENCY 


The example from Listing 2 shows how 
to deal with variables as exponents. Here 


LISTING 3: CALCULATOR.SH 


#!/bin/bash 

# calculator.sh 

read -p „First number: „ a 

read -p „Operation: „ op 

read -p „Second number: „ b 

echo -n „$a $op $b returns”; spigot --rn 


-d50 \($a$op$b\) --printf 210.2f 
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you see that the variables are isolated by 
quotes; the e-12 describes the exponent’s 
remainder. Use the script to calculate the 
frequency of a resonant circuit using the 
coil (Inductance, ?H) and the capacitor 

(Capacitor, pF). See Figure 5 for the Figure 6: You can save operation symbols within a variable. 


script’s output. 
SS of tuning range LC oscillating circuit 


VARIABLES WITHIN VARIABLES pome | 
A very useful feature is including the | 
symbols for operations (+, -, *, /, 

etc.) within a variable. As you may get 
negative numbers in random opera- s 
tions, remember to enclose variables | Teds be ung + 
inside brackets (Listing 3). Figure 6 | 
shows the output enclosed within | 
commas. | 


| Rotary capacitor: highest value in 
| Rotary capacitor: lowest value : 

‘ubuntuuser@ubuntuuser-XPS> 
| 
| 


PLOTTING RESULTS | 
You can modify the circuit script to 
output results and plot a graph. For 
example, You can measure tuneable 
resonant circuits (frequency variation 
using a variable capacitor). In the ex- 
ample in Listing 4, both Pi (pi) and the | 
square root function (sqrt) are used 
too. | zz 2 

The for loop specifies the maximum | “eyes 
value for capacitance (cmax) of the Figure 7: Spigot not only calculates data, but also displays it as a graph if necessary. 
variable capacitor, which is reduced 
by one, until the minimum value 
(Cmin) is reached. The results (values CONCLUSION 
for capacity and frequency) are placed Spigot is a powerful calculation tool, al- 
in a table. Using gnuplot [4], the script though some of the operating concepts 


then creates a diagram, which is dis- initially seem cumbersome. However, 
played on the screen. You will need to once you have familiarized yourself with 
install the gnuplot and plotutils pack- the features, you can even perform com- 
ages for this to work. Figure 7 shows plex calculations in the blink of an eye 
the script’s output. using automated scripts. « 


LISTING 4: VFO.SH 


#1/bin/bash 

# vfo.sh 

# Delete any existing resuits table 
rm resultstab.txt 


clear 
echo „Calculation of tuning range LC oscillating circuit” INFO 

COND) ee rane ase ree aes acim ne = erin = ” 

read -p u coj l:inductance in ?H: „1 [1] Simon Tatham: http:/www.chiark. 
read -p „ Rotary capacitor: highest value in pF: „ cmax greenend.org.uk/~sgtatham/ 

read -p w Rotary capacitor:lowest value in pF: „ cmin Ss 4 

# cmin decrease by 1 in a for loop [21 Spigot: http//www.chiark. 
cmin=$(echo Scmin | spigot .basel0fd:0-1') greenend.org.uk/~sgtatham/ 

for ((c=cmax; c>cmin: c--)) spigot/ 

do [3] Manual: http:/www.chiark. 


qrg=$(spigot --rn -d50 .$1“e-6*“$c"e-12 | spigot --rn -d50 ,(1/(2pi*sqrt(basel 


greenend.org.uk/~sgtatham/ 
Ofd:0))/1000000)* --printf %10.3f) 


spigot/spigot.htm! 
echo „$c $qrg” >> resultstab.txt pigowspig 

done [4] Gnuplot: http:/gnuplot. 
gnuplot -p -e „plot ,resultstab.txt* using 1:2” sourceforge.net 
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__HITTPIE 


The ultra-slim web server HTTPie turns out to be an elegant synthesis of curl and wget, making it 
ideal for use with pipes. 


WEB SPY 


BY HARALD ZISLER —_ 
TTPie has many features of as detailed website analysis. Output 
wget and curl, allowing vari- can be redirected to a file, and file in- 
ous types of data transfer. It’s puts are also possible. This makes 
also suitable for tasks such HTTPie [1] ideal for use with pipes. 


On Ubuntu, you can install HTTPie 
using apt: 


HTTP/1.1 260 OK 
Cache-Control: no-store, no-cache, must-revalidate, post-check=8, pre-check=6 

Connection: Keep-Alive { 
ontent-Encodt: gzip 

‘ontent-Length: 7537 

‘ontent-Type: text/html; charsetsutf-8 


sudo apt install httpie 


ontent- language; en-US 


or grabbing the latest version of the ate: Fri, 9S May 2017 16:14:49 GMT 

xpires: Thu, 19 Nov 1982 68:52:06 GMT 

i i ep-Alive: tineout=5, max=100 

source code from the GitHub repository sstnsdivieds FEU 6s hay, 2017 16:14:49 GMT 

ragna: -cachi 
[2]. erved-by? ies bunturuser con 

i i . ever: Apache/2.4.7 (Ubunt 
Call HTTPie using the command: gst cookteistdeibe atterkads279sgrakgehsi7; path=/ 
Mary: Accept-Encoding 
-Powered-By: eZ Publish Conmuntty Project 
http <options> <method> <URL> Inocryre html PUBLIC "-//W3C//DTD XHTML 1.0 Transittonal//EN" “http: //www.w3.org/TR/xhtnl1/0TD/xhtnli-transtt 
D he 
font xnlns="http://www.93-0rg9/1999/xhtnl” xmlzlang="en-US" lange"en-US"> 
z P : Ehead 

If you don’t specify any options, fee ee <titleHone - ubuntu User</tttle> | 
you’ll just see the website’s code | 
(Figure 1). | <neta nane="Content-Type” content="text/htnl; charset-utf-8" /> 

| <meta nane="Content-Language” content="en-Us" /» | 
IMPORTANT OPTIONS | <neta nanes"author™ content="Linux New Medta USA, LLC" /> | 
Table at lists some of HTTPie’s the { <meta nane="copyright” content="Linux New Media USA, LLC" /> | 
most useful options, while Table 2 Figure 1: You can call a web page without any additional options. 
lists important access methods to 
HTTP ubuntuuser@ubuntuuser-XPS-M1330: ~/Pictures/httple/material 

Servers. ubuntuexerqubuatauser-XPSeNt3902~/Pictures/httpte/matertal$ sh query.sh 192.168.1.24 
GET / HITP/1.4 
Accept: */* pre 
ept- dtng: 5 
Wes Pace OuTPut Eenrectton: heep-attve SS nS 
i r jost: 192.168.1.24 

One pitfall when outputting web User-agent: WiTPLe/0.9.8 
pages is that http detects whether HrTP/2.1 200 OK 


‘onnectton: Keep-alive 
‘ontent-Encoding: gzip 
ontent-Length: 3641 

ontent-Type: text/html 

ate: Fri, 05 May 2017 17:32:03 GMT 
7 “29¢d-5473b66f401dT-gztp” 


Eee bytes 


output is redirected or given to a 
pipe. With standard usage, you'll £ 
find yourself frustrated at every | 


ep-Alive: tineoutss, nax=160 
ast-Modifted: Sun, 29 Jan 2017 13:08:59 GMT 
erver: Apache/2.4.16 (Debian) 

ary: Accept-Encoding 


LISTING 1: QUERY.SH 

#1 /bin/bash 

# Example 1 Querying a Web Page 

http --print Hh $1 

echo | 


turn: 


# Example 2 Query HTTP methods, for the Figure 2: Output of web pages and further processing. 
next- 
# Processing, the -v option is required: http <IP> / <name> <file> 


echo -n „Possible HTTP methods: ., 
http -v options $1 | grep Allow | cut -d: 
-f2 


simply does not work. 

To resolve this, you need to use the 
-v or --print options along with the 
command. You can use the option 


TABLE 1: OPTIONS 
Action Option 


Specify the output scope ~print HBhb H (request header), B (request body), 
h (reply header), B (reply body) 
A 


-v = 


“Complete output” for pipe 
and output redirection 


-d [URL] Alternatively: --download [URL] 


Assign name to a down- -o [FILENAME] | Default: Original name 
load 

Resume interrupted down- | -c - 

load 

Specify user name -a [USERNAME] | - 


WWW.UBUNTU-USER.COM + UBUNTU USER IsSUE33 41 


42 


ISSUE 33 


ituuser-XPS-M1339:-/Pictures/httpte/natertal$ http --print H 192.168.1.24 


ccept-Encoding: gzip, deflate 
Konnection: keep-altve 

Ost: 192.168.1.24 
jiser-agent: HTTPte/0.9.8 


tuvsergubuntuuser-XxPS-N1336:~/Pictures/httple/matertal§ http --print h 192.168.1.24 
TTP/1.1 260 OK 
cept-Ranges: bytes 


‘onnection: Keep-Alive 


ype: text/htal 

A, 05 May 2017 17:37:42 CHT 
*29cd-5473b66f401df-gzip" 

Mive: tineout=5, max=180 

ffiled: Sun, 29 Jan 2017 13:68:59 GMT 
+ Apache/2.4.18 (Debian) 
Accept-Encoding 


Jbuntoneceubentusser-KPatiawee-/Pictures/httpts/nstertals L 


| 


Figure 3: Use the option --print to capture different parts of the back and forth with the server. 


shown in Listing 1 and Figure 2 for in- 
stance. In this example, the web 
server was also prompted to list avail- 
able HTTP methods (again refer to 
Table 2). 

Use the --print HhBb option to nar- 
row down what HTTPie shows, and 
see what you send and receive. You 
can use this for shell scripts. Listing 
1 uses this technique. Figure 3 
shows the output of two requests 
sent to the same web server. The 
first shows the request header (-- 
print H); the second shows the reply 
header (--print h). 

If you want to check the HTTP sta- 
tus codes, use the following command 


http --print h 192.168.0.83 | 2 
grep „HTTP“ | cut -d“ „ -f3 


in the shell script. Note the blank 
character used as a field separator 
for the cut command. 


DOWNLOADING FILES 


You can use the -d [URL] option to 
download files. Figure 4 shows the 


LISTING 2: CONTROL.SH 


#1 /bin/bash 
# Usage: control.sh <site URL> <user to 
email> 
# Variable to accept the exit code 
1=0 
# Variable that memorizes the previous state 
flag=l 
while true; do 
http -v $1 | grep ,empty“> /dev/null 
1=$(echo $?) 
if [ $] -eq 0 1; then 
if [ $flag -eq 1 J; then 
echo „Message: empty” | mail -s „Normal 
Message“ $2 
# Reset $flag to Normal” 
flag=0 
fi 
else 
if [ $flag -eq 0 J; then 
echo „Message: error“ | mail -S „ERROR 
MESSAGE” $2 
# Set $flag to „Error“ 


If you look at the first line of the flag=1 
second example’s output in Figure 3, t 
you can probably figure out what E a 
the line will return: OK. ene 


TABLE 2: Most UseruL HTTP METHODS 


Command Function 


Request contents of a web server (default) 
Request web page headers. 


Output the request as it arrives at the requested web server 


options Lists the HTTP methods allowed on the requested web server 


post 


Send data to the web server (e.g., in the form field = value) 


Send a file to the web server 
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output of this command. You'll see 

the download progress in the termi- 
nal. The header details are interest- 
ing. They recognize the type of pay- 
load, as well as the size and date of 
the last process. 

You can resume interrupted down- 
loads without restarting, as long as 
the server has been configured to 
handle partial content. To do this, 
assign your own filename to the 
download (-o FILENAME) and also 
set the -c option. The full command, 
in the right order, would look some- 
thing like this: 


http -dco unicorn.pdf 2 
https://openclipart.org/pdf/2 
203567/1414101992.pdf 


WesDAV DownloaD 

The option -a [USERNAME] also al- 
lows you to connect to Web Distrib- 
uted Authoring and Versioning 
(WebDAV) services and download 
files. Figure 5 shows how to get 
started. For example, using the -v 
option, you can use the get request 
with a resource. 

Download the contents of a Web- 
DAV directory into your working di- 
rectory using -d, and examine it ina 
browser, such as w3m. Naturally, 
you can parse the output through 
pipes instead and then, for instance, 
start to download very specific data. 

Deletion is performed using the 
HTTP method delete. You must spec- 
ify the complete resource, so wild- 
card characters won’t work. In Fig- 
ure 6, you can see http with delete in 
action. 


SCRIPTING 

This is not a tool for homemade In- 
ternet surveillance. However, you 
can access device controls via a web 
interface or even pages with defined 
values, and so on. Often these have 


LISTING 3: TESTSITE.HTML 


<html> 

<body> 
<hipTest Site</hi> 
<p>192.169.124 Test field<p> 
<p>(Keyword: empty)<p> 
</body> 

</html> 


WWW.UBUNTU-USER.COM + UBUNTU USER 


ubuntuuser@ubuntuu 


XPS-M1330: ~/Pictures/httple/material 


pbuntuusergubuntuuser-XPs-M JPtctures/httpte/natertal$ http -d https://openclipart.org/pdf/203567/1414101 
992. pdf 
HTTP/1.1 200 OK 
public, max-ages604960 
eep-alive 
th: 226235 

application/pdf 
Fri, OS May 2017 20:09:54 GMT 
1423295938 

nginx 
Transport-Securtty: nax-age=31536000 


Downloading 220.93 kB to "1414101992.pdf" 
Done. 220.93 kB in 0.430095. AGES 16 kB/s) 
t-/Pletures/httpte/matertats ff 


cure 4: Downloading a file with HTTPie. 


ubuntuuser@ubuntuu 
pbuntuuse user-XP5-M13 
UserS7aabd7/Product. pdf 


http: password for paul@vww,ajaxftlebrowser.con: 
GET /us uct.pdf HTTP/1.1 


XPS-M1330: ~/Pictures/httpie/material 
:-/Pictures/httpte/natertal$ http -a paul -v -d http://www.ajaxftlebrowser.con/ 


ng: identity 

on: Basic cGFibDo= 
tion: keep-alive 

www. ajaxfllebrowser.con 
Agent: HITPte/9.9.8 


HTTP/1.1 200 OK 


Iccept-Rang 


bytes 


tials: true 
ers: Overwrite, Desttnation, Content-Type, 
X-File-Size, X-Requested-with, 


Depth, User-Agent, Translate, Range, Conte 
If-Madifled-Stnce, X-File-Nane, Cache-Control, Location, Loc 


jnt-Range, aeneoliks 
k-Token, If 


ACL, CANCELUPLOAD, CHECKIN, CHECKOUT, COPY, DELETE, GET, HEAD, LOCK, MKCALENDAR, 
PROPFIND, PROPPATCH, PUT, REPORT, SEARCH, UNCHECKOUT, UNLOCK, UPDATE, VERSION-CON 


MOVE, OPTIONS, POST, 


NKCOL, 
TRO! 


DAV, content-length, Allow 
“21 7483647 


e: applicatton/pdf 
RERS @S May 2017 23:44:04 GMT 
"5/5/2017 11:18:39 PH 0° 

c Fri, 05 May 2017 23:18:39 GAT 
ft- ATTPAPI/1. o 
IT Hit WebDAV Server 


„Net v3.9.2075.6 (Evaluation License) 


Downloading 11.42 kB to "Product.pdf" 
Done. 11.42 kB in 6.218948 (52.18 kB/s) 2 : | 


Figure 5: Download a file from a WebDAV resource. 


jubuntuuser-XPS-M1330: ~/Pictures/httpie/material 
t-/Pletures/httpte/matertal$ http -a paul -v delete http://www.ajaxftlebrowser. 


Mbuntuusergubuntuuser-XPS-M13: 
con/User57aabd7/Product. pdf 
password for 


jaxftlebrowser.con: 
df HTTP/1.1 


: gzip, deflate 

Basic cGFibbo= 

keep-alive 

ength: © 

www. ajaxftlebrowser.con 
HITPie/0.9.8 


true 
ers: Overwrite, Destination, Content-Type, Depth, User-Agent, Translate, Range, Conte 
X-File-size, X-Requested-With, If-Nodifted-since, X-Flie-Nane, Cache-controt, ‘Location, Loc 


fit-Range, Tineout, 


Token, If 
l ethods: ACL, CANCELUPLOAD, CHECKIN, CHECKOUT, COPY, DELETE, GET, HEAD, LOCK, MKCALENDAR, 
HKCOL, MOVE, OPTIONS, POST, PROPFIND, PROPPATCH, PUT, REPORT, SEARCH, UNCHECKOUT, UNLOCK, UPDATE, VERSTON-CON 


{TROL 


DAV, content-Length, 


H Allow 
2147483647 


1 Fri, 0S May 2617 23:51;50 GNT 
Microsoft-HTTPAPI/1.0 


TT Hit WebDAV Server .Net v3.9.2675.6 (Evaluation License) 


1530:~/Pictures/httpte/matertats I 


Figure 6: Deleting a file i in the WebDAV directory. 
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ubuntuuser@ubuntuuser-XPS-M1330: ~/Pictures/httpie/material 


buntuuser@ubuntuuser-XPS-M1336:~/Pictures/httpie/material$ mail 
\"/var/mail/ubuntuuser": 3 messages 3 unread 


>U 1 ubuntuuser sáb may 6 10:4 16/575 Normal Message 
u 2 ubuntuuser sáb may 6 10:5 15/549 ERROR MESSAGE 
| U_ 3 ubuntuuser sáb may 6 10:5 15/550 Normal Message 


2 


Figure 7: Overview of the status emails. 


no mail interface, so you would have 
to access the web page at irregular 
intervals. 

The shell script in Listing 2 moni- 
tors the contents of a simple web 
page (like what you can see in List- 
ing 3). If the keyword “empty” ap- 
pears, everything is fine. A mail for 
this is only sent when the script is 
started or after an error has been re- 
ported and then amended. If some- 
thing changes, then an error mes- 
sage is sent. The target mailbox is 
not flooded with identical error mes- 
sages thanks to a flag that keeps 
track of when changes occur. 

The script takes two parameters: the 
URL of the webpage you want to mon- 
itor, and the user to whom you want 
to send the warning emails. Running 
the script would look like this: 


control.sh www.somesite.com/2 
test.html <user? 


For all of this to work, you will have 
to install the mailutils package: 


sudo apt install mailutils 


Choose Internal only from the op- 
tions the installer gives you, and 
then set up mail to work with your 
user. You do this by first making 
your user join the the mail group: 


http://192.168.1.24/tests\ x 


€ © 192.168.1.24/testsite.htm c >» 


Test Site 


| 
| 
| 192.168.1.24 Test field | 


(Keyword: empty) 


; http://192.168.1.24/tests x Hapan 


€ © 192.168.1.24/testsite.htm ecel» =| 


| 
Test Site | 


| 192.168.1.24 Test field 
(Keyword: Internet) 


Figure 8: Above, the unmodified monitored 
page; below the modified monitored page. 


sudo usermod -a -G mail <user> 


Next you have to create an email 
box for user by sending an internal 
email to the user. You can do this as 
root with: 


sudo mail -s „First email” <user> 


You can see the internal emails you 
receive by simply running mail. 

Figure 7 shows what happens dur- 
ing a test run: new emails show up 
in you mailing list. Figure 8 (top) 
shows the sample page, which was 
altered (bottom) for demonstration 
purposes while the script was run- 
ning. 


CONCLUSION 

HTTPie is a compact, well-rounded 
tool for data download and analy- 
sis. This article covers some of the 
basic functions. The other notes 
on the project page and on the 
man page are always a worthwhile 
read. « 


INFO 


[1] HTTPie: https:/httpie.org 


[2] Download: https:/github.com/ 
jakubroztocil/httpie 
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Routino is an offline route-planning application that uses OpenStreetMap data to calculate 
efficient and convenient routes. We discuss what this software can do. 


Using Routino as a free offline route planner 


PATH FINDER 


BY FRANK HOFMANN & PAUL BROWN 


he idea behind a route planner is to 

calculate a suitable route between 

two geographical points, the start 

and the end point. The basis for a 
route planner consists of a database popu- 
lated with data about specific routes and 
their relevant characteristics. 

Ideally, searching the database should 
occur with minimal compute time and re- 
sult in the most efficient route that is also 
the shortest or fastest. There may be addi- 
tional search criteria to consider, such as 
mode of transportation, route characteris- 
tics, type and condition of route, plus spe- 
cifics about the time of day and the season 
of the year when the route is to be used. 

All of the providers who offer maps and 
navigational systems also offer matching 
online services and software. Frequently, 
there are also accompanying apps for 
smartphones. The providers offering these 
products and services include Falk, ViaMi- 
chelin, TomTom, Nokia/Map24, and 
Google Maps, among others. As it turns 
out, free route planners compete nicely 
with commercial providers in terms of vari- 
ety and quality. In some instances, the free 
planners actually perform even better. 


The online tools OpenStreetMap [1], 
Open Source Routing Machine (OSRM) [2], 
GraphHopper [3], and BBBike [4] have cre- 
ated an excellent reputation for themselves. 
There are also offline programs that let the 
user navigate independently of the Internet 
and therefore without access to data from a 
server (see the “Everything Online” box). 
These programs include Navit [5], Os- 
mAnd [6], OpenStreetMap for Android [7], 
and Routino [8]. 


Routino 

The project describes Routino as software 
that specializes in finding routes between lo- 
cations on the basis of topographical infor- 
mation contained in the OpenStreetMap 
(OSM) project. The software calculates the 
shortest or the quickest path. For its calcula- 
tions, Routino uses a specially adapted data- 
base that divides individual parts of a path 
into segments, which are then grouped to- 
gether according to similar characteristics. 

After setting up the program (see the 
“Installation” box), you will still need map 
content as OSM data. The Geofabrik [9] 
website is ideal for browsing for this kind 
of content. Once you have loaded the con- 
tent you want, use planetsplitter to process 
the maps. This tool comes as part of the 
Routino package. 

We have chosen the map content for the 
Western US, which you can find on Geo- 
fabrik in the us-west-latest.osm.bz2 file. Use 
the prefix usw with planetsplitter to be able 
to differentiate the files you have chosen 
from any future maps you'll use: 


$ planetsplitter --prefixeusw 2 
us-west-latest.osm.bz22 


This will take awhile, maybe hours, but 
when it is done, you will be rewarded with 
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four files: usw-nodes.mem, usw-relations. 
mem, usw-segments.mem, and usw-ways. 
mem. This shrinks the original 2GB of 
compressed data to about 1.5MB. Figure 1 
shows an excerpt of the extensive output 
during processing. 

This is sufficient for calculating routes 
via the command line. If instead you use 
the application via the web interface, then, 
as administrator, you should copy the four 
files that are created to the /var/lib/routino/ 
data/ directory. With Debian and Ubuntu, 
it is important to make sure that individual 
files get copied [10] without a prefix. The 
simplest approach is to rename the four 
files once they are in the target directory. 

Routino calculates routes for all of the 
main modes of transportation. Obvious 
variants available for the profiles include 
automobile, pedestrian traffic, bicycle, mo- 
torcycle, and truck. In addition, you will 
also find variants like horse, wheelchair, 
and local public transport. 

You can also specify a preferred roadway 
type. Moreover, the program takes the pres- 
ence of one-way streets into account, limits 
on loads and the size of a vehicle, barriers, 
and restrictions on turning directions. The 
same goes for other characteristics like the 
roadway conditions and speed limits. 


ON THE COMMAND LINE 
You should use the call from Listing 1 if 
you want to calculate the shortest path be- 
tween two points. The -dir parameter is 
used for naming the directory with the 
routing data and the -transport parameter 
for the selected means of transport. The 
-shortest button is used to indicate that 
you want the software to find the shortest 
route. 
Routino also requires two pairs of coordi- 
nates for latitude and longitude, lon1/lat1 
and lon2/lat2. 
The -language parameter determines the 
language that is used to describe the route. 
If no language has been indicated, the out- 
put will be generated in English. Specifying 
--output-html generates a file by the name 
of shortest.html. Figure 2 shows the recom- 
mendation together with a map where the 
route is outlined. In this case, we are look- 
ing at the route between 108 Lighthouse 
Avenue in Pacific Grove, Monterey, and 
Monterey Airport. 


BROWSING 
‘To access the web interface for the program, you 
have to install the routino-www package first: 


f 30: 
| 


test.osn] 


pead: Lines=509799452 Nodes=184457926 Ways=14115708 Relations=97008 | 


= OSM Data 
rted Nodes: Nodes=184457926 Duplicates=6 
Sorted Ways: Ways=4327066 Duplicates=0 


orted Route Relations: Relatlons=69340 Duplicates=228 
sorted Turn Relattons: Relattons=23262 Duplicates=0 


recess OSM Data 


li 


PLetures/Rovttno/Matortals planetsplitter --prefixsen us-west-latest.osn.bz2 


al 


| 
Checked Ways for unused Nodes: Ways=4327066 Highway Nodes=59126654 


Split Ways: Ways=4327066 Segments=61310415 

jorted Way Names: Ways=4327066 
Updated Ways with Names: Ways=4327066 Nanes=629469 
Sorted Segnents: Segnents=61310415 
Processed Segments: Segnents=61310415 Duplicates=12139 
[Indexed Segnents: Segnents=61298276 

rocessed Route Relations (1 


| 
Renoved unused Nodes: Nodes=184457926 Highway=59126654 not -Highway=125331272 | 
| 


1 Relattons=69112 Modtfled Ways=291 


rocessed Route Relattons h: Relations=68526 Modifted Ways=0 
rocessed Turn Relattons: Relattons=23135 Deleted=1014 Added=887 


y5=4327066 Unique=830009 
sorted Nodes Geograph’ Nodes=59126654 
sorted Segnents Geograph : Segnents=61298276 


orted and Compacted 
y: 
indexed Segnents: Segnents=61298276 


jorted Turn Relations Geographically: Turn Relattons=23135 


rune Unneeded Data 


ded Extra Segment Indexes: Segnents=61298276 


runed Straight Highway Nodes: Nodes=59126654 Pruned=27535621 | 


eleted Pruned Nodes: Nodes=59126654 Pruned=27535593 


sorted and Pruned Segnents: Segnents=61298276 Deleted=27535621 
o! 


ted and Compacted Ways: Ways=830009 Unique=830009 


_Pruned Turn Relations: Relations=23135 Pruneds6 


Figure 1: You can use the Planetsplitter tool to prepare the OSM data so that Routino can use it to 


calculate the path. 


sudo apt install routino-www 


This will install also the Apache web server 
(if you don’t already have it) and some 
other dependencies. The contents of the 
Routino web are in /usr/share/routino/ 
www, and you should make them accessi- 
ble for the Apache web server with: 


sudo chown -R www-data:www-data 2 
/usr/share/routino/www 


In theory, you should now be able to 
visit http://localhost/routino with your 
browser and see the map information, 
but if you open the address, you'll see 
controls on the left of the window, but a 
blank space where the map should be on 
the right. 

Turns out the program cannot find an 
essential component, leaflet.js, a library 
that reads and graphically shows map 
data. Download it from [11] and unzip it 
to /var/www/html/javascript/leaflet. You 
will have to do this as root, which 
means you will again have to make the 
contents accessible for the server before 
everything works correctly: 


sudo chown -R www-data:www-data 2 


/var/www/ javascript 


The final step is to make sure Apache 
understands and executes correctly the 
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EVERYTHING ONLINE 


It is a good idea to store maps and 
route information online and also re- 
trieve them from there if needed, be- 
cause the data volume involved can 
be significant. You can often get by 
with just a portion of the maps and 
route data that is offered. If needed, 
you can later load an additional por- 
tion of the data or missing pieces. 


INSTALLATION 


You will find all of the packages neces- 
sary for Routino in the official reposi- 
tories for Debian and Ubuntu. These 
include routino (route computer, com- 
mand-line tool), routino-common 
(data for Routino), plus /ibroutinoO 
and /ibroutino-slim0 (routing librar- 
ies). In addition, you will need routino- 
www and javascript-common, as well 
as a web server like Apache(apache2) 
or Nginx (nginx) for the web interface 
and browser display. 
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Shortest Route 


j] papeista tend sou ist 
j e 0374 kna, O.A mea J0. Am, 6 mates] 
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AL uncon, go STRAIGHT ON Reading SOUTH 
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Figure 2: The software can output the culated route as an HTML page that is simple to open in 
the browser. There you can review the data and the map. 


Perl-rich pages Routino generates to 
show the results - which is something 
else that is messed up in the web inter- 
face in Ubuntu. 

The first thing you have to do is make 
sure the /etc/routino/apache.conf looks 
like what you see in Listing 2. 

You can comment out the lines 


Require ip 127.0.0.0/255.0.0.0 
Require host localhost 


so they look like this: 


#Require ip 127.0.0.0/255.0.0.0 
#Require host localhost 


Because then you will be able to access 
the web interface from any device on 


Listing 1: CALCULATING ROUTE 


$ routino-router --dir=/var/lib/routino/data --transport=motorcar --shortest --lonl=-121.923498 
--latl=36.623598 --lon2=-121.850284 --]at2~36 587442 


--language=en --output-htm] 

Loaded Files: nodes, segments, ways & relations 
Found Closest Point: Waypoint 1 

Waypoint 1 is segment 6482339 (node 5640986 -> 5641028): -121.923410 36.623722 = 0.015 km 
Found Closest Point: Waypoint 2 

Waypoint 2 is node 5974815: -121.850554 36.587151 = 0.040 km 

Routing from waypoint 1 to waypoint 2 

Found Start Route: Nodes checked = 3 

Found Finish Route: Nodes checked = 4 

Found Middle Route: Super-Nodes checked = 4071 

Found Combined Route: Nodes = 133 

Routed Ok 

Generated Result Outputs 
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your local network rather than just from 
the machine on which the program is 
running. 

In the next step, open the /usr/share/ 
routino/www/results.cgi file and change 
the line that says 


require „router.pl“; 
to 


require ,/usr/share/routino/www/2 
router.pl”; 


Save and close the file. 

You have to do the same with the /usr/ 
share/routino/www/router.cgi and 
change the line that says 


require ,router.pl*; 
to: 


require ,/usr/share/routino/www/2 
router.pl"; 


In /usr/share/routino/www/router. pl, 
you have to change the line 


require ,paths.p1"; 
to: 


require ../usr/share/routino/www/2 
paths.pl"; 


And the line that says 
require „profiles.pl“; 


to: 


LISTING 2: /ETC/ROUTING/APACHE. 
CONF 


Alias /routino /usr/share/routino/www 
<Directory /usr/share/routino/www> 


AddHandler cgi-script .cgi 
LanguagePriority en 
ForceLanguagePriority Prefer Fallback 
Options +ExecCGI 

AllowOverride None 

Require ip 127.0.0.0/255.0.0.0 
Require host localhost 
<FilesMatch .*\.pl$> 

Require all denied 
</FilesMatch> 
</Directory> 
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require ,,/usr/share/routino/www/2 
paths.pl“; 


Finally, in /usr/share/routino/www/sta- 
tistics.cgi, change the line 


require „paths.pl“; 
to: 


require „/usr/share/routino/www/ 2 
paths.pl"; 


Once you're done with the changes, you 
can restart the Apache web server: 


sudo systemct] start apache2 


Then, visit http://localhost/routino and 
start planning your trips. Figure 3 shows 
what the web interface looks like once it 
is working. 

You will find the navigation function 
on the left side of the interface and the 
results on the right. Settings include op- 
tions for the interface language, a maxi- 
mum of nine route points, transportation 
method, conditions along the route, and 
the type of use. 

However, we were unable to get the 
green line that marks the shortest route 
between the points or the blue line that 
represents the fastest. These lines do 
show up on the demo site at [12]. How- 
ever, if you float the cursor over the di- 
rections on the left, a circle will show up 
on the map showing where you should 
be. 

Pressing the left mouse button lets you 
move the map section. In order to recal- 
culate the route, you should first move 
the corresponding point on the route and 
then click either on the Shortest route 
button or on Fastest route. 

You will find the results for the route, 
the appropriate GPX track, various route 
descriptions, and also the corresponding 
coordinates on the Results tab. Routino 
uses the Data tab to reference the data- 
base that has been used. This means 
that Routino provides information on the 
number and size of the nodes and also 


the stored segments. 


Jy Doaotice 

The times calculated by Routino for the 
route should be taken with a grain of 
salt. Figure 2, for example, shows that 


€ © localhost 


l . UE me 


wotnre 


Tes Dassen ] 


Figure 3: The Routino web interface offers the same functions as the tool for the command line, 
but with a nice graphical interface. Be prepared to do quite a bit of tweaking to get it to work on 


Ubuntu. 


Routino indicates that the nearly 10 kilo- 
meters between Pacific Grove and the 
Monterey Airport in California requires 
seven minutes. In reality, this amount of 
time only applies when the road is 
empty of all other traffic, all lights are 
green, and the maximum permissible 
speed is maintained. 

Uwe Steinmann is the developer be- 
hind the software. He himself admits 
that the time indications are optimistic 
and that the program does not take traf- 
fic volume into account. Routino derives 
the travel speed solely from the type of 
roadway. Since calculations have been 
done offline purely according to dis- 
tance, the speed factor appears to play a 
subordinate role [9]. 


CONCLUSION 

For daily use, Routino shows itself to be 
very quick and reliable. However, you 
should keep in mind that the validity of 
this observation is based on a number of 
variables, including the OSM files that 
have been loaded to the database and 
the section of the map that is selected. 
For regions that are less well mapped, 
the program delivers quite meager re- 
sults. For urban areas that have been 
mapped out in detail, the software gen- 
erates reliable routes. The functional de- 
sign and the ease of use for the tools 
make a positive impression. This is one 
of the reasons that the program QMap- 
Shack utilizes the tools for local calcula- 


tions. 
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INFO 


[1] OpenStreetMap: http://www. 
openstreetmap.org 

[2] OSRM: http:/project-osrm.org 

[3] GraphHopper: https://www. 
graphhopper.com 

[4] BBBike: http:/www.bbbike.org 

[5] Navit: Attp:/www.navit-project. 
org 

[6] OsmAnd: http:/osmand.net 

[7] OpenStreetMap on Android: 
http://wiki.openstreetmap.org/ 
wiki/Android 

[8] Routino: http:/www.routino.org 

[9] Geofabrik downloads: http:/ 
download.geofabrik.de 

[10] “Finding a Way for Routing”: 
http://blog.madbob.org/ 
finding-a-way-for-routing/ 

[11] Leaflet.js: http:/leafletis.com/ 
download.htm! 

[12] Routino demo (only the UK): 


http:/www..routino.org/uk-leaflet/ 
router.htm! 
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o DESKTOP Pras Activities 


KDE Plasma Activities remove the limitations of having a single desktop and allow you to have 
multiple environments with their own sets of launchers for applications, files, and URLs, each 


customized for a single purpose. 


Practical uses for KDE Plasma Activities 


KEEPING ACTIVE 


BY BRUCE BYFIELD 


ost users of KDE Plasma 
have probably heard of Ac- 
tivities [1], but few ever 
use them. The trouble is 
that, although Activities have been a 
feature of Plasma for almost a decade, 
detailed examples of how to use them 
are few and far between. The result is 


that one of the most useful expansions 
of the classic desktop metaphor re- 
mains neglected, leaving users strug- 
gling along with desktop environ- 
ments that are barely adequate for 
modern systems. 

Classic desktops with a menu, 
panel, and workspace worked well 


when 200MB hard drives were the 
norm. However, as systems have 
grown, users have been struggling 
with a growing problem. Either their 
desktop is so crowded with launchers 
that finding the one they need be- 
comes difficult, or else it contains a 
general set of icons that may not be 
ideal for any specific task. Increas- 
ingly, users have become accustomed 
to launching applications from the 
menu and leaving the desktop a blank 
space - a solution that is less than 
ideal because modern menus have 
also become unwieldy. 

Activities remove these difficulties 
by removing the limitation of a single 
desktop. Each Activity is a separate 
desktop, with its own set of launchers 
for applications, files, and URLs, cus- 
tomized for a single purpose. Since 
any purpose rarely requires more than 
a dozen launchers, each resource can 
be quickly located. 

Just as importantly, each Activity 
provides a specific rather than a gen- 
eral set of resources. All of these re- 
sources are a single click away, provid- 
ing immediate access without the dis- 
traction of drilling down a menu. Ac- 
tivities themselves can be reached by 
keyboard shortcuts or by adding the 
Activities Bar widget to the desktop 
(Figure 1). 

Although users may be unaware of 
the fact, Plasma’s default desktop is 
an Activity. For some users, this single 
Activity is all they need. However, 
those who want to organize them- 
selves more efficiently can add Activi- 
ties by selecting Activities from the 
desktop toolkits (Figure 2). 

In Plasma 5, an Activity can have 
two layouts. A Desktop layout is one 
to which you can add launchers freely. 
By contrast, with a Folder View, the 
entire desktop displays the contents of 
a directory. This directory can be 
added to contain launchers, like the 
default desktop, or else a directory 
displaying files and directories as in a 
file manager, as shown in Figure 3. 

And how can these features be used? 
A flippant, if truthful answer would be 
any way you imagine. However, if you 
are like most users, the following case 
studies should help you jump start 
your imagination. 


FULL-SCREEN APPLICATIONS 


Like virtual workspaces, Activities are 
a convenient place to run applications 
like a web browser or a terminal that 
you want to run full-screen. The dif- 
ference is that, in Plasma 5, virtual 
workspaces cannot be customized in- 
dividually. With Activities, you can set 
up applications permanently so that 
they can run at a click. 


ORGANIZING TASKS 

You can limit the number of icons on a 
workspace using a filter, but having a 
separate Activity for a task reduces the 
necessary amount of fiddling with 
controls. Probably, task-based Activi- 
ties are the most common. In fact, 
when Activities were newer, one of the 
examples circulating was a sample by 
Aaron Seigo of an Activity for plan- 
ning a holiday. If I remember, it in- 
cluded links to airlines and hotels, as 
well as websites about historical sites 
and tourists attractions at his destina- 
tion. 

Figure 4 shows the icons on the Ac- 
tivity that I have set up for writing. On 
the left are the tools I use for writing: 
Bluefish and LibreOffice. Bluefish is 
placed on the left because it is the one 
I use the most, since most of the edi- 
tors for which I write prefer articles in 
plain text or with minimal HTML for- 
matting. 

In the middle are URLS for online re- 
sources I use frequently: an Old Eng- 
lish dictionary for translation, a rhym- 
ing dictionary, and a thesaurus. I do 
not include a general purpose diction- 
ary, because I make a point of never 
using a word I am unable to spell, but 
others might find such a link useful. 

On the far right are directories I use 
for housekeeping. The income-2017 
folder includes invoices I have submit- 
ted and a spreadsheet listing every- 
thing I have written for the year and 
how much | am owed for each article, 
with separate columns for American 
and Canadian dollars and Euros. The 
2017 folder contains the actual stories, 
both as I submitted them and as I re- 
vised them at editors’ requests. 

Originally, my Writing Activity also 
included a link to a screen capture Ac- 
tivity. However, I soon realized that 
running the applications I was writing 
about in the same workspace as my 
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Figure 1: The Activity Bar widget is a conve- 
nient way to switch between Activities. The 
current Activity is highlighted — here, the 
default desktop. 


Activities Qe 


Chromebook 


Utilities 


+ Create activity... 


Figure 2: You can view Activities from the 
desktop toolkit. 
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you might want when logging in for 
the first time during the day, such as a 
world clock, a weather app, and re- 


Wallpaper 


| cent KDE news. By placing these utili- 
Hees [epea | ties on their own Activity, you can 


8 Wallpaper Type: Folder View | take advantage of them without them 
| Mouse Actions Hei | getting in the way of your other com- 
| Positioning: | Scaled {v | puting 
| % Background Color: EE] | Note, though, that Figure 5 is taken 
| — Tweaks — — = == from a machine with 32GB RAM. On 
Figure 3: In Plasma 5, each Activity can have a Desktop or Folder View layout. smaller machines, a dozen widgets 


constantly polling hardware and sys- 
writing tools cluttered the desktop and tem resources or connecting to online 


slowed me down. These days, I run sources can easily slow a system to a 
the applications in a separate Activity. crawl. In such cases, you need to be 
For instance, since I write a regular more selective. 


command-line column for Linux Pro 
Magazine, I have an Activity named Your Own CHROMEBOOK 


CLI that displays one launcher for As you probably know, Chromebooks 
screen capture, and one for Konsole, are laptops that use online applica- 
KDE’s terminal application. tions rather than local ones. Chrome- 
For larger projects, I often have sep- books have become popular because 
arate Activities. When I was writing of their low price, and also because 
my book Designing with LibreOffice storing resources online is easier for 
[2], I had an Activity that included Li- those using several machines or col- 
breOffice, which I was using both for laborating with others. 
writing and as a reference, a screen You can create your own version of 
capture app, and links to the chapter a Chromebook in an Activity that con- 
file directory and the chapter graphics tains only URLs. The Activity can con- 
directory. tain links to Google Docs and Google 
Calendar for general productivity, Re- 
ARRANGING WIDGETS member The Milk for to-do lists, and 


Plasma’s widgets can be placed in the Google Drive for file storage and shar- 
panel, but you can also place them on ing (Figure 6). If necessary, you can 


the desktop, where they are always also add Activities customized to use 
open and readable at a glance. Desk- local applications as well. 

top widgets include useful items such 

as the trash can, or, in the Plasma 5 URL SCRAPBOOK 

releases, a full-screen menu. However, Web browsers have bookmarks so 
you probably want to view some wid- that users can easily find links they 
gets only occasionally, and too many want to use later. However, Activi- 
widgets can get in the way and canbe ties make saving links for later use 
started accidentally. even easier. 

One solution is to place all your All you need is an Activity with a 
desktop widgets on to a single Activ- link to a web browser. When you want 
ity. The example in Figure 5 starts to save a URL, drag it to the desktop, 
with hardware and system monitors and save it with an appropriate name. 


on the two left-hand columns, such as Group URLS if you need to organize 
RAM, disk usage, and CPU Activity. In them. 

the middle column, there are everyday 

utilities, such as a calculator and mea- | ORGANIZING BY LOCATION 

surement conversion app, with a sys- Although Activities are usually orga- 
tem update on the bottom. In the far nized by task or project, another way 
right column, there is information that to organize them is by location. For 


Sp PRP SD 


Old Rhymes Thesaurus 


English 


Figure 4: An Activity set up for writing, showing launchers for applications on the left, URLS in the middle, and files on the right. 
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example, if you use your computer at 
work, home, and school, you could 
create Activities for each of these loca- 
tions. 

On the Work Activity, you could add 
launchers for LibreOffice, the directory 
containing your work files, a to-do list, 
and URLS for your company’s or de- 
partment’s Slack channels. On the 
School Activity, you might include 
BasKet, KDE’s note-taking application, 
and a Calendar for assignment and 
exam dates. On the Home Activity, the 
launchers could include your favorite 
games and the URLs for Google + and 
Twitter, making them accessible with a 
single click. 


Activities Vs. VIRTUAL DESKTOPS 
These examples demonstrate some of 
the basic ways that Activities can ex- 
pand and improve your desktop envi- 
ronment. However, if you are like most 
people, you might be uncertain how 
Activities differ from virtual desktops, 
except for having different tools for 
navigating them. The difference is es- 
pecially obscure in distributions that 
are still using Plasma 4, in which vir- 
tual desktops can be configured inde- 
pendently - a feature that has yet to 
find its way into Plasma 5. 
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' Google 
Drive 


: Se ea ‘ Mik 
Figure 6: Launchers for an Activity for using cloud applications — a kind of do-it-yourself Chromebook. 


The answer is that Activities have 
the same relation to virtual desktops 
as directories have to files. In other 
words, they are a higher level of orga- 
nization. Each Activity has its own 
virtual desktops and, in Plasma 5 is 
more specialized and customizable 
than its virtual desktops. 

Making full use of Activities means 
analyzing how you use computers. 
Often, it means structuring desktop 
environments in terms of tasks, rather 
than applications. It can also mean 
much more customization of wallpa- 
per and launcher icons than the classi- 
cal desktop requires. 

However, like all customization, the 
payoff is an increased ability to work 
and navigate more efficiently and with 
fewer distractions. Activities require 
thought and preparation, but once you 
start using them, you are likely to feel 
half-crippled when using a desktop 
environment that lacks them. e 


INFO 


[1] An introduction to Activities at 
KDE's Userbase site: https:// 
userbase.kde.org/Plasma# 
Activities 

[2] Designing with LibreOffice by 
Bruce Byfield: http:// 
designingwithlibreoffice.com/ 
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DESKTOP  Trouá 


Trojitá is new to the scene of email clients, but it already stands out for its intuitive interface and 
speed. Even so, this client is still missing some essential functions. 


An overview of the IMAP client Trojitá 


NIMAL M 


BY MARIO BLATTERMANN 


inux is not lacking at all for tions that fulfill simpler needs in- 
email programs. The frontrun- cludes the rather ancient Gnome tool 
ners include Evolution, Thun- Balsa, Claws Mail, and the fairly new 
derbird, and KMail, all of which Geary. 
are feature-rich PIM suites (see the Trojitá was built on version 5 of the 
“PIM” box). Many users just need a Qt libraries, and for some time now, it 
simple mail program and nothing has been trying to enter this product 


else. The stable of slimmer applica- category. Before it can qualify as a via- 


General] Mar ROmine meshes 


General 


|| Method | Network Connection | Method 
|| Encryption | Force encryption (TLS) _ h i | Encryption 
|| sere O oll lene 
| Port 3) |e) ec: 
| Use System Proxy Settings ¥ | | | | Authenticate 
| Needs Network v | | 
| | Username ubuntuuser@gmx.com| @| j | | 
| | Password | oc a sea 7 o a| | | | 
i) i | 
| | | 
| I) | 
| Extension Blacklist jË ; N — B | 
|| Timeout of IMAPIDLE [29 a W i 
| Refresh Interval | 300 seconds p 2 | | | 


| 
| Use IMAP Credentials ¥ | | 


| Save Outgoing Mail O | 
l 


_ Cancel 


| cancel 


Figure 1: This is where you configure the Trojitá mail client for receiving messages. 


ble alternative, this newcomer needs 
to be evaluated with an eye toward the 
fact that it only works with the IMAP 
protocol (see the “IMAP” box). Since 
almost all of the providers offer access 
via this protocol, this restriction does 
not disqualify the software outright. 
Currently, there are no plans to extend 
its capabilities to other protocols. 


INSTALLATION 

Trojitá is not in the default Ubuntu re- 
positories, but there are packages made 
for your distribution. To install them, 
enter 


sudo sh -c „echo 2 
„deb http://download.opensuse.org/2 
repositories/home:/jkt-gentoo:/2 
trojita/xUbuntu_16.04/ /* > 2 
/etc/apt/sources.list.d/2 
trojita,list* 


to add the Trojitá repository, and then 


wget 2 
http://download.opensuse.org/2? 
repositories/home: jkt-gentoo:2 
trojita/xUbuntu_16.04/Release. key 

sudo apt-key add - < Release.key 


to add the repository’s key and avoid an- 
noying messages about unsigned repos. 
Finally, to install the software, enter: 


sudo apt update && sudo apt 2 
install trojita 


You will find Trojitá in your launcher. 


SETUP 
To set up an email account, open the 
setup dialog by clicking on the IMAP | 
Settings menu. Clicking on Add brings 
up a screen where you can enter your 
name and email address. A single click 
on Save stores the data, which however 
is not quite all that is needed. Estab- 
lished competitors like Thunderbird, 
KMail, and Evolution refer to the domain 
in the address line when they search for 
the correct settings in terms of server 
and port. Trojitá does not yet do this. 
The parameters for receiving messages 
are entered in the IMAP tab (Figure 1). The 
online help offered by providers usually tells 
you what you should enter here. Typically, 
this includes information like the server’s 
name, its port, and the encryption technol- 
ogy used for transmitting your messages. 
Similarly, the SMTP tab (Figure 2) is 
used for entering data for sending mes- 
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Figure z Configure the sending of emails in the SMTP tab. . 


PIM 


PIM stands for personal information 
manager. This type of software han- 
dles tasks like mail, contacts, notes, 
and scheduling. PIM software, particu- 
larly on mobile devices, plays an in- 
creasingly important role for private 
users alongside its traditional role in 
the business and professional worlds. 


IMAP. 


IMAP is an Internet access protocol 
that was developed more than 30 
years ago. It lets the user retrieve 
emails from a server where they con- 
tinue to be stored. This means that 
moving, deleting, and copying emails 
takes place on the server and not on 
the local computer. 
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From GMX 
To Ubuntu User 


| Thank you for signing up and welcome to GMX! 


ject v — From Date Sie | 
| Spam \& Failed access via e-mail program GMX System... 19:43 18.1... 


martes, 9 de mayo de 2017 19:29:27 (CEST) ~ 


Plaintext | HTML 


IMAP Protocol 


19:49:21.407 
19:49:21.407 


Opening network session 


Connection o X 


Session is open (configuration Wired connection 1), online state: online 


Welcome 


Figure 3: By default, Trojitá uses a proven layout. Modifications can be made with justa few 
clicks. 
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Figure 4: The application has a special function 
that helps you keep a handle on the costs of 
connecting to the server. 
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sages. In most cases, it is a good idea at 
this point to remove the check mark 
from the Save outgoing mail option, 
since almost all providers automatically 
save copies of sent messages in the Sent 
folder. Moreover, sending the first mes- 
sages in our test failed because the pro- 
gram was unable to find the default Sent 
folder. 

Last, but not least, you should go to 
the Offline tab and indicate how the pro- 
gram should handle messages that have 
already been called. By default, Trojitá 
saves emails for 30 days. If you do not 
trust your provider’s data security prac- 
tices, then you should select the Store 
forever option. 

Although the settings might give you 
the impression that the application is 
able to administer multiple accounts, 
this is in fact not the case. The program 
does permit a user to provide more than 
one identity, but the parameters for re- 
ceiving and sending remain the same. 
You can remedy this situation by collect- 
ing emails from various mailboxes on 
the server into one mailbox. 

Trojita's current version can correctly 
handle aliases if you enter multiple ad- 
dresses. Aliases are available from free 
software communities, which tend to be 
especially generous in giving them out. 
However, the aliases actually consist 
merely of redirects rather than a genuine 
mailbox. These alternative addresses 
should nonetheless be properly regis- 


tered with your email provider; other- 
wise, you will not be able to successfully 
send emails since the server software as- 
sumes that the address is fake. 


Work PROCESSES 

Once installed, the client loads messages 
from the server. The main window’s ap- 
pearance makes it clear that the develop- 
ers have not reinvented the wheel (Fig- 
ure 3), There is a tree view of the IMAP 
folder to the left, the header bar sits at 
the top, and the text below. This ar- 
rangement is familiar from other clients 
who use it, because it optimizes the use 
of space on smaller screens. 

If need be, you can go to View | Lay- 
out and change the layout so that the 
three areas either lie next to one another 
or are viewable only one at a time. The 
horizontal view is especially advanta- 
geous for a tile screen manager. 

There is a small icon at the top right 
edge of the screen that is particularly in- 
teresting for mobile devices. When 
clicked, it opens a selection of billing 
methods for the server connection. You 
can either switch the data connection off 
entirely, or you can choose between a 
volume-based connection and a genuine 
flat rate (Figure 4). 


MAKING Contact 

The contact list is one of the bread-and- 
butter features for any mail client. None- 
theless, you should not expect too much 
from Trojitá. While Trojitá does have an 
address book, this feature has only the 
most rudimentary of functions. The easi- 
est way to add contacts is to click on the 
small button with the person icon that 
sits to the right of the address for a mes- 
sage. This opens an editor window 
where you can enter additional data, like 
a postal address or telephone number if 
needed. 

At this point, the address book win- 
dow still looks like it hasn’t been com- 
pletely implemented yet (Figure 5). 
Searches for a contact that are performed 
with part of the name do work, but it is 
not clear at the outset whether an edit- 
ing function for the entries on the right 
side of the window exists. 

However, once you click between the 
square brackets, a cursor appears. Once 
you have made changes, the question 
becomes how to save them. You will 
look in vain for a save button. Luckily, 
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Trojitá is clever enough to prompt you 
upon closing the window whether the 
edited contacts should be saved. 

The software does not let you auto- 
matically put addresses from emails you 
have received into the contact list or 
even a separate list. This would do away 
with the necessity of having to explicitly 
save an address. At least the editor has 
an auto-complete function, which works 
if it finds a relevant contact entry (Figure 
6). 

In this age of data that is synchronized 
on stationary, portable, and mobile hard- 
ware, It no longer seems possible to do 
without consistent contact data. The 
success enjoyed by smartphones and 
cloud storage has made data alignment 
under Linux much easier. Current email 
clients are easily adapted to operate in- 
terfaces like LDAP, the Google and Face- 
book address books, and even Microsoft 
user accounts. 

Trojita‘s address book is not yet this 
advanced. There are no onboard tools 
for aligning data with lists from the 
email provider. Internally, the program 
uses the data format and the storage lo- 
cation from the address book Abook [2]. 
This is often used in combination with 
the email client Mutt. The address book 
usually resides in the home directory in 
.abook/addressbook, This makes for var- 
ious possibilities that generally do not 
integrate into the email program. In- 
stead, they require additional software. 

For instance, you can import to the 
vCard format using the Python script vc- 
f2addressbook [3]. This script is avail- 
able for export from the provider's web 
interface or from local applications. The 
best way to save the script is to do so 
with the vCard file exported beforehand 
in the relevant ~/.abook/ folder and 
then assign corresponding rights using: 


chmod +x vcf2addressbook 


The output saves the call together with 
the name of the VCF file as an argument 
in the addressbook file. The script saves 
the existing file in a new one that in- 
cludes a .bak extension. You can keep 
the list up-to-date by regularly backing 
up your contacts and executing the 
script. However, the update process 
overwrites the contacts saved directly in 
Trojitá. In order to prevent the loss of 
data, it is a good idea to combine the file 
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BE::Contacts 


Filter j | 


| Arthur Dent 


arthurdent@earth.com 
[url] 
Address 

[address] 


Lip] [city] 
[state] [country] 


Notes 


Nick [nick] 
Anniversary [anniversary] 
Custom notes [notes] 


| Phone 


Office [workphone] 
Mobile [mobile] 
Home [phone] 
Fax [fax] 


Add e) 


saved in the vcf2addressbook with the 
backup. The Awk script in Listing 1 
takes care of this. 

Save the script, and call it with the 
command 


$ awk -f addressbookmerger.awk 2 
<Adressbook_1> <Adressbook_2> > 2 
<Adressbook_new> 


LISTING 1: ADDRESSBOOKMERGER. 
in the folder that contains both the old 


AWK 
and the new address book. After renam- 
ing the merged lists as addressbook, it is BEGIN | 
ready to use. The process gives the im- FS = =" 
pression of being a creaky ladder rather print wif abook addressbook file“ 
than a stable bidirectional gateway, but print »[format]” 
it does actually work. In reverse, there is arinueorduransencok 
still no way to export any contacts for pranueeversion=0s6¢62 
the more common formats that are suit- aii 
able to other programs. anne 
ENCRYPTION ee 
GnuPG and S/MIME play an increas- } 
ingly important role in the encryption (aane 
of private communications. Trojitá ige 
cannot handle S/MIME, but it does nane[i J++ 
work with PGP. Nonetheless, you will getline 
not find any pertinent button that lets email[i] = $2 
you protect the text of an email you ) 
have written from people who want to END { 


snoop. 

The technology is used for the first 
time in the current version and is 
played up in the release notes as an 
important advancement. Even so, as 
the notes themselves point out, the 
function is only available for received 
messages. Provided you have already 
installed GnuPG, then the encryption 


for ( i in name ) í 

print „Ce count „]” 
print „name=“ i 
print ,email=" email[i] 
print „“ 


count++ 
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From | Ubuntu User <ubuntuuser@gmx.com> = FA ~l | 


hur Dent <arthurdent@e 


Subject | 


% Cancel 


Figure 6: Trojitá automatically completes addresses from the address book as you type them in the 
"To" field. 


process works smoothly. Handling 
messages that carry digital signatures 
also works without a hitch. To date, 
only external tools are available for 
administering the key. 

In some ways, the Trojita‘s current 
behavior is reminiscent of the first 
SMS-capable mobile phones from 
more than 20 years ago. These phones 
could receive and display short mes- 
sages but were not able to send them. 
It took the next generation of devices 
to solve that problem. Therefore, there 
is room for hope that the Trojitá devel- 
opers will likewise add to the existing 
functions in the future. 

The software also offers a spam fil- 
ter, which in actuality consists of an 
option for manually marking emails as 
spam. However, the function merely 
marks the corresponding messages. 
The application does not move these 
messages to the appropriate folder. It 
also does not have a filter that applies 
a spam filter to the view. 

It became clear during testing that 
the software is incompatible with vari- 
ous desktop themes. This is particu- 
larly true when Gtk widgets were used 
to help Qt create the interfaces. Prob- 
lems occurred in displaying colors 
under these conditions. 


58 Issue 33 


E (TOE 


The information about encrypted 
email appeared in white print and was 
barely legible against a light yellow 
background. It seems that the develop- 
ers made a mistake when modifying 
the KDE theme Breeze. There are ex- 
press references to the innovation that 
these modifications are intended to 
represent in the release notes for the 
latest version 0.7. 


CONCLUSION 

Given its austere functionality, we 
have reservations about recommend- 
ing Trojitá for everyday use. But if you 
are a user who wants to avoid the 
stress of Thunderbird or KMail, then 
this program can give you a reprieve. 
The interface has a lean and logical 
design with the caveat that the soft- 
ware cuts corners when it comes to 
convenience. However, its speed more 
than compensates for the lacking fea- 
tures, 

The mail client landscape in the Qt 
ecosystem is sparse. Trojitá already 
integrates well into desktops like 
LXQt and KDE. There is cause for op- 
timism now that the application 
source code is in the KDE Git reposi- 
tory and project presentations are 
found in Bugzilla and the KDE User- 
Base wiki. Perhaps Trojitá, especially 
under KDE, will become a more via- 
ble alternative with the connection to 
Akonadi and its potential successor 
[4]. 

At this time, the incomplete imple- 
mentation of GnuPG is a drawback. 
You can choose to either do without 
this tool or wait for future develop- 
ment. While it is possible to encrypt a 
message before sending it, actually 
doing so turns out to be more cumber- 
some than convenient. e 


INFO 


[1] Trojitá: http:/trojita.flaska.net/ 

[2] Abook: http:/abook.sourceforge. 
net/ 

[3] Script for converting from VCF to 
Abook: hittps:/github.com/dglent/ 
vef2addressbook/blob/master/ 
vef2addressbook.py 

[4] Akonadi successor: https:// 
community.kde.org/KDE_PIM/ 
Akonadi_Next 
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What?! 


Archives come with 
my digital subscription? 


Sign up for a digital subscription to get 
the latest issues of Raspberry Pi Geek, 
PLUS access to archive articles. 


shop.linuxnewmedia.com That’s a lot of articles! 
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lf you can master the idiosyncrasies of this software, then you will be able to edit audio files in a 


flash. 


The unusual ideas of EKO sound editor 


MODERN MIXER 


BY MARIO BLATTERMAN 


inux has a whole range of applica- 

tions that are used for recording 

and editing sounds. Among oth- 

ers, these include Audacity, which 
sets very high performance standards for 
the genre, and KWave, which comes 
from the KDE community. Work on the 
competitor EKO [1] has been ongoing for 
the last six years, but most larger distri- 
butions still take a pass on the software. 
This reluctance even applies to Arch 
Linux, where you will need to build the 
program from the source code (see the 
“Installation” box). 


INITIAL START 
The program makes a somewhat strange 
impression when it is first opened (Fig- 


ure 1). The interface’s layout closely re- 
sembles other similar programs. But in 
spite of the Qt basis, EKO looks more 
like a post-modern Java Swing GUI that 
doesn’t appear to fit in with the rest of 
the desktop. The user-interface widgets 
match fairly well with the desktop. How- 
ever the same cannot be said for the 
icons. 

You will experience more weirdness 
when you open an audio file using File | 
Open. Instead of giving you a selection 
window, the software jumps to the Files 
tab in the bar on the right and embeds 
the dialog directly in the main window. 
The opened file gets displayed in a time- 
line and is divided into channels (Figure 


Before delving deeper into the menus, 
you should devote some attention to 
configuration. This is done by clicking 
on Help | System Check. The application 
will display the external tools it has 
found for reading in and exporting files. 

Additional settings are specified in the 
Options tab found in the right-hand bar. 
The Common tab is used to modify vari- 
ous basic settings like the lame com- 
mand for exporting to MP3 format, plus 
the user-interface language. 

In addition, you should specify how 
many steps the software saves during 
editing, thus giving yourself the possibil- 
ity of reversing steps if this is necessary 
(Figure 3). An option like this might 
seem superfluous because you can cre- 
ate obstacles for yourself under certain 
conditions. Nonetheless, the developers 
made a firm decision to build it in. 

If needed, you can use the Sound de- 
vices tab to specify sources where the 
program will get data, and where this 
data will be sent. During testing, it was 
not necessary to change any of the other 
default settings. The software accurately 
recognized the correct devices. 

The keyboard settings in the Keyboard 
tab are also rich with possibilities. Short- 
cuts can be created for almost all of the 
functions. The selection options even let 
you realize fast access to files that have 
already been opened. 


EDITING 

The editing process in this tool is pretty 
conventional. EKO puts the playback 
buttons in the toolbar. Clicking in the 
timeline and then dragging the cursor 
lets you select an area. Clicking the 
looped checkbox activates infinite loop 
playback . 

The software offers a number of tools 
in the Functions menu that can be used 
to modify marked segments. These tools 
let you do things like insert silence, per- 
form dynamic response compression, 
and reverse the channels. There are also 
tools that can be used to generate tones 
and noise. 

The mixer surprises with some very 
interesting gimmicks. It opens right 
away in a separate window when the 
program starts. If you have a smaller dis- 
play, you might not see this separate 
window because lack of space causes it 
to simply disappear behind the main 
window. 
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| [21:49:53] EKO 5.3.1 @ http://semiletov.org/eko (| 


| or hitps://github.com/psemiletov/eko | 
| by Peter Semiletov (tea@list.ru) 
read the Manual under the learn tab! 


[FiF | 


Figure 1: EKO adheres to conventions followed by most of the sound editors in this sector except 
that the decision to include unusual icons is distracting. 


Clicking on the plus icon that sits 
above the spin control opens another 
small window. This is where you find the 
functions for adding echo, distortions, 
and the crackling typical of vinyl records 
(Figure 4). You won’t always be able to 
deduce the type of a particular effect 
from the name given to the function. Ex- 
perimentation works best in this regard. 


INSTALLATION 


The newest version, EKO 5.3.3, can be downloaded from the project site. The web- 
site offers a few tips on integrating the program into the system. 


In addition to the Ot libraries in Version 4 or 5, you will need the /ibportaudio, lib- 
sndfile, and libsamplerate packages, plus accompanying developer files. EKO itself 
does not remind you that the packages jack, mplayer, ffmpeg, and lame are re- 
quired for the import and export of sound files. Instead, users are on their own to 
figure out which of these is needed. 


The installation process consists of three steps, namely qmake, make, and make in- 
stall. There may be two binaries on your system for qmake. These would have the 
corresponding suffixes for Ot4 and Ot5. For now, the choice is yours as to which 
one you want to use. 


The makefile installs the program files at /usr/local/. If need be, you can modify the 
path in the eko.pro file. 


A binary package for Fedora was created while we worked on this article. You will 
find this package online [5]. Additional and partially updated RPM packages are 
available in various supplementary repositories for openSUSE [6] and ROSA [7]. 
Users of Debian and Ubuntu-based distributions are out of luck at this point. You 
will need to rely on descriptions for installing the program from source. You should 
also be aware that the setup does not create a menu entry. Starting the program is 
accomplished via the fast start window or by issuing the eko command in the ter- 
minal. 
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/home/mariobl/Musik/Johannes Brahms - Ungarische Tänze 1-21/05 - Ungarischer Tanz Nr. 5 in g-Moll - Allegro. Vivace.ogg YD G 


Odette - 


| 05 - Ungarischer Tanz Nr. 5 in g-Moll - Allegro. Vivace.ogg | 


|[22:12:56] elapsed: 746 ms _ 


| [22:12:55] /home/mariobl/Musik/Johannes Brahms - Ungarische Tanze 1-21/05 - Ungarischer Tanz Nr. 5 in g-Moll - Allegro. Vivace.ogg is 


open 


[21:49:53] EKO 5.3.1 @ http://semiletov.org/eko 


or https://github.com/psemiletov/eko 
‘by Peter Semiletov (tea@list.ru) 


sramie eh Aor Dfmnnnnm anon el mine om 


SS 


FF | 


p Wama 


(00:00:00.000 <-> 00:02:22.933 = 00:02:22833 


Figure 2: When you open up an audio file, you will find yourself in a familiar looking view for editing sounds. 
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You will find a few unanticipated 
quirks hidden in the workings of the 
EKO functions. For example, it is not 
possible to just export a marked area to 
a new file. You first need to copy the 
area via File | Copy, then use File | New 
to open a new editing area, and finally, 
insert the data there. This procedure 
does not sound logical, and that is be- 
cause it is not. Another surprise lurks in 
the playback function. Instead of stop- 
ping when it comes to the end of a 
marked area during playback, the soft- 
ware merrily continues onward. 

EKO has an onboard tool for fading in 
and out when you want to straighten up 
a piece of music. This tool is found in 
the Functions | Fade menu. It works ac- 
curately on the marked area even though 
controlling the intensity of the process 
requires several passes. There are no pa- 
rameters available. 

You might be interested in enlarging a 
marked area so that you can analyze it 
better. The audio editor enlarges file 
areas in a roundabout way. The View 


menu option does not have a corre- 
sponding entry. Instead you have to go 
to Edit | Trim where the appropriate set- 
ting for changing the marked area to 
the size of the window has been hidden 
away. Repeating the procedure multiple 
times should get you into the range of 
individual oscillations. During testing 
however, the program alternately 
crashed, or it generated unusable 
views. 


EXPORT 

Currently, only WAV and MP3 formats 
are available for saving files. MP3 is gen- 
erated via the Lame encoder by saving 
the data via: 


File | import/Export | Export to MP3 


If you merely save the file, the tool auto- 
matically selects the uncompressed WAV 
format. 

Even though the settings offer a pa- 
rameter for modifying the free Vorbis 
codec, this format does not appear in the 
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exporting options. Nonetheless, there is 
a workaround for saving data in other 
formats. The command line for Lame ac- 
cepts plain text in the settings. This 
means you can simply enter another 
command. The entry for MP3 will con- 
tinue to be displayed in the menus, but 
the results we achieved during testing 
were correct. 

Regardless of the format selected, EKO 
does not attach any metadata to ex- 
ported files. Therefore, playback pro- 
grams subsequently need an external ed- 
itor in order to recognize what they are 
dealing with. The VLC media player and 
the Gnome application EasyTAG [2] are 
well equipped to take on the task of rec- 
ognition. 


HELP 
The Help menu offers support for dis- 
covering the possibilities of this tool. 
The software includes documentation 
directly in the main window, thus con- 
cealing the opened editor. In order to 
look up functions, you have to switch 
back and forth between editor and 
text. It would be more practical if you 
could swap between support and the 
editor in a single window, but this 
does not work. Looking in the web 
browser is also not an option because 
the help text is part of the monolithic 
EKO binaries. 

An “EKO Manual” in HTML format 
is available on the project’s GitHub 
page [3]. 


CONCLUSION 

The project website is largely silent 
about the origin and meaning of the 
program name. There is a vague refer- 
ence to the word “Echo.” During test- 
ing, we came up with another name 
that we thought might be more fitting. 
We would call the program an “Idio- 
syncratic Sound Organizer.” 

Even though the program orients it- 
self primarily toward other editors, it 
arbitrarily insists on unique settings 
labels. This approach cuts into the no- 
tion that the solution is innovative. 
The concept behind displaying multi- 
ple windows on small screens with 
limited resolution is particularly im- 
practical. Although the software’s be- 
havior when files are opened is a 
pleasant surprise, it does not rise to 
the level of actual progress. 
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C) Override locale jen 
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4: 01:45] 32 bit float data 


:45] samplerate: 44100 |. 
(14: 00:29] elapsed: 21 ms 
[14:00:06] Press Stop to stop recordina! = 


FF | Mama 
Aiae aaa re EE | 
Figure 3: During configuration, some of the settings you create will probably not be needed in 
actual practice. 


Consistency across the desktop is 
usually part of the design for other 
programs, not so for EKO. As a result, 
the software currently positions itself 
somewhere between recording tools 
like Gnome Sound Recorder and the 
mature tools for sound artists that are 
mentioned above. It is not clear 
whether EKO will make it into the lat- 
ter category. 


O Vynil Taste 


gL GR 
If you are not bothered by the off- | 


Figure 4: The mixer is able to realistically gen- 
erate the typical crackling of a vinyl record. 
Unfortunately, the reverse action of removing 
crackling, something that would be helpful to 
he restoration of recordings, does not work. 


beat design, and if you don’t want to 
grapple with the umpteen possibilities 
and options found in KWave or Au- 
dacity, then EKO is certainly worth 
trying. e 


INFO 


[1] EKO: http:/semiletov.org/eko/ 

[2] EasyTAG: https:/wiki.gnome.org/Apps/EasyTAG 

[3] Help on GitHub: https:/github.com/psemiletov/eko/blob/master/manuals/en.html 

[5] Copr Repository for Fedora: https:/copr.fedorainfracloud.org/coprs/mariobl/Eko/ 

[4] Source code tarball: http:/semiletov.org/eko/#downloads 

[6] Package for openSUSE: hitps:/software.opensuse.org/download.html? 
project=multimedia%3Aapps&package=eko 

[7] Package for ROSA: http/wiki.rosalab.com/en/index.php?title=Blog:ROSA_Planet/ 
ROSA_Enterprise_Desktop_X2#Additional_Repositories 
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With Eskil, you can easily compare the differences between files. If necessary, you can even 
compare them with a version control system. 


The graphical diff tool Eskil is packed with features 


NOR CHANGES 


BY HARALD ZISLER 


aintaining program code 

is almost like moving 

pieces on a chessboard: 

you can observe column 
and line changes precisely between 
moves. However, if this analogy is 
stretched to imagine a board that 
has far more than the usual 64 
squares, extended over several lev- 
els, the human eye is hardly suffi- 
cient for spotting changes. Diff pro- 
grams such as Eskil [1] can be used 
to help analyze lengthy blocks of 
code. 

Eskil’s program interface is unre- 
markable; software functions are 
nestled behind very simple menus. 
Eskil works with Tcl/Tk, so install 
this first. If necessary, download the 
software from the website. The “In- 
stallation” box provides information 
on how to do this manually. 


STARTUP 

If you start Eskil from the terminal, 
you can directly invoke files (Listing 
1, line 1) or directories (Listing 1, 
line 2) for comparison. There are 
some interesting options you can 
use on the command line, many of 


which you can read about in Table 1. 


Alternatively, you can open files in 
the program interface via the menu 
item File | Open both ... - first left, 
and then the right. 


By default, the font size is very 
small. Click Options | Font | Select 
..., and select the type and size of 
the font to fix this. The default fonts 
are all monospaced, i.e., the charac- 
ters all take up the same amount of 
horizontal space (Figure 1). 


INSTALLATION 


Download the latest GZIP package 
from [1] and uncompress it with: 
gunzip eski1273.1inux.gz 


Version 2.7.3 was the latest version at 
the time of publication. 

Make the uncompressed files execut- 
able with: 


chmod a+x eskil273,linux 


and Eskil is ready to launch: 
-/eski1273.1inux 


You can also move the executable file 
eskil273.linux to /usr/local/bin/or an- 
other directory on your PATH and cre- 
ate a symbolic link for eskil. Just like 
that, it will be available to all users. 


You can move the program manually 
to your desktop environment's Start 
menu. Some file managers also allow 
you to create a desktop shortcut. If 
you want to edit files from within 
Eskil, install Emacs. 


xwé 


vrozhko, 123RF 
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Uncheck the Fixed box to see a list 
of all installed fonts. However, avoid 
these for text files as the overview 
will become muddled with a vari- 
able width font. Save your settings 
with Options and Save default. 


COMPARING TEXT 

In the example shown in Figure 2, 
the tool compares the text file air- 
port.py (left) with airport2.py. The 
various color codings indicate addi- 
tions, changes, or missing text. Table 
2 summarizes the corresponding sys- 
tem for marking the deviations. 

The toolbar helps you to work 
through differences step by step. Ac- 
tivate this with Options | Toolbar 
(Figure 3). The software then dis- 
plays the selected line numbers in 
red on a yellow background. Click 
on Next Diff to view the next differ- 
ence. You can use Prev Diff to jump 
back to the previous difference, too. 

If you prefer to work with a felt tip 
pen and ruler, or simply want to dis- 
play differences in black and white, 
use File | Print PDF .... You can use 
this menu to remove colors and 
other frills. 


MERGE 

To merge files, click Tools | Merge. A 
new pop-up window (Figure 4) will 
open, where you can jump between 
divergent data using the Next and 
Prev buttons. You then decide 
whether you want to use the version 
in the main window on the left (L) 
or on the right (R). 


If you want to insert differences in- 
stead, use the functions LR and RL in- 
stead of L or R. With LR, the text in 
the left column remains unchanged; 
differences in the right column are 
listed below. In the case of RL, this 
works in exactly the opposite way. 


Comparing DIRECTORIES 

With Eskil, you can compare the 

contents of different subdirectories. 

After the program has started, the 

software to do this will load. The 

following rules apply to the color 

scheme for object names: 

è Black indicates identical objects 
on both sides; 

è Red on both sides indicates they 
aren’t identical; 

e Blue indicates objects that exist 
only on the left. 

e Green indicates objects that exist 
only on the right. 

Figure 5 shows what the above looks 

like. The left column contains the 

contents of both subdirectories. If 

you want to move up a level in the 

directory tree in the left pane, click 

on the button with the single green 

arrow on the left of the toolbar. If 

you want to move up in the direc- 

tory tree in the right pane, do the 

same using the button with single 


LISTING 1: OPENING FILES 


01 $ eskil <BB1>filel<BBI> <BBI>File2<BBI> 


02 $ eski] <88BI>Folder1<88I> 


<B81>Folder2<881> 


Figure 1: If the font is too small, the software 
allows you to select a different font and/or 
font size. 


TABLE 1: PROGRAM OPTIONS AT 


STARTUP 


Parameter Action 
Open files at startup 


Lines before and after 
the deviation 


Create PDF file with 
deviations only 


-context <n> 
(or just <n>) 


-print <file> 


Compare tables 
(changes are dis- 
played in the affected 


l 
column) 


Opt ionParser 


InageDraw 


apo: 


F Load modules: 


33; codecs 


Figure 2: Both text files contain almost the same content. The tool highlights any differences using color coding. 
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Log Revert Commit Prev Diff Next Diff 
ort.p 


[home/ubuntuuser/Pictures/Eskil/Material/airport2.] 
hon 


Eile Select Goto Config 


“~iR@@ AR ARL 


PURPOSE, 
GNU General Public License for more details. 


# Load modules 


from optparse import Opti 
import Image 

import ImageFont, ImageDraw 
import random 

inport string 

import os 


arser 


import codecs 


a; D] 


Figure 4: Use the Merge function to merge two files with differences. 


green arrow on the right of the tool- 
bar. If you want to move up in both 
panes, use the button with the dou- 
ble arrow in the center of the tool- 
bar. 

Go down the directory listings by 
right-clicking, and then choose go 
down left or go down right. Right- 
click on the directory under Struc- 
ture to call other functions. 

Use Expand all to open the entire 
structure to be compared in the win- 
dow. Conversely, Collapse all will 
display the folder comparison as a 
small symbol beside Structure. You 
can access these same functions by 


TABLE 2: CoLoR RULES 


clicking on the small arrow icon, 
which opens and closes directory 
trees. 

If you want to list identical ob- 
jects, use prune equal. However, 
there is no option to remove this fil- 
ter in the Context menu. Instead, 
use Alt+C or File | Compare to 
switch back to full view. 

Compare files marked as different 
(red) by clicking on them in the Struc- 
ture column to highlight the line. Next, 
mouse over one of the data columns 
and right-click. The Context menu will 
open, and you can select Compare 
Files. Your comparison window will 
now appear. 

If you want to copy a file completely, 
use the buttons on the arrow in the 
Copy column or by right-clicking Copy- 
File to... in the source column. This 
will sync files on a case-by-case basis. 

This does not work the same way for 
subdirectories. Although the program 
here offers the arrows, you cannot use 
them to make copies of folders. Eskil 
also does not allow you to create new 
directories and copy data to them. 

The program does not automatically 
update the display after a command is 
run. Use Alt+C or File | Compare to re- 
fresh. 


Color Left File Right File Meaning 


Difference in line numbers 
[Green |x |- [Deviation from the left side 


Blue z X Deviation from the right side 
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PRIVACY | 't mi : 
Stay free with these Don t miss a single 
\\ anonymity solutions issue of the magazine 
that delivers the 
Z | . in-depth technical 
= eel MARCH 2017 s - MAGAZINE solutions you'll use 
ara everyday! 
PRIVACY. lai 


Safe surfing with Tails ¢ 


i Signal 
Snowden’s choice fora 
| messenger app 


A 
Set Up Amazon Web Services EAA 


SAVE TIME ON 
DELIVERY WITH 
OUR PDF 
EDITION 


| Bitmessage 
| Private communication 
ee an email server a AÁ 
e ty pe 


| Linux Foundation’s serk F ; 
Jim Zemlin: KDE Connect. 


"Great developers Horna Android 
are like poets." he KDE deskto 


i AWW LINUX-MAGAZINE.COT A 


shop.linuxnewmedia.com/subs 


F DESKTOP Fu 


Eje Preferences Tools Help 


fw. 


e| è | [homejsbuntuuserPictures/authors 4% | momejubuntuuser/Pictures/Eskil 2) 2 | 
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Figure 5: The Compare Subdirectory window is more complex than the Compare File view. 


Tip 


If you click on Edit Left File or Edit 
Right File in the menu, an editor opens, 
and you can modify the file if neces- 
sary. Emacs was used in our test, but 
you can specify a different editor using 
the file ~ /.eskilrc. To do this, enter the 
line in Listing 2 and save the file. 


VCS INTEGRATION 

Eskil can be integrated into version 
control systems (VCS) whereby several 
systems are used in parallel. According 
to the Eskil website, the tool supports 


LISTING 2: CHANGING THE DEFAULT 
EDITOR 


set ::Pref(editor) <BBI>editor<BB1> 


INFO 


RCS, CVS, Git [2], Fossil [3], Mercurial 
[4], Bazaar [5], and Apache Subversion 
[6]. Other diff tools, such as Perforce 
and ClearCase, don’t support these 
functions. 

If you use more than one system in a 
directory, Eskil prefers the variants Git, 
Mercurial, and Bazaar to CVS and Sub- 
version. Use the options -svn or -cvs to 
manually clear programs with the same 
name. 

We used Git to test this feature. Start 
the program and click on File | Revision 
Diff. Next, select the local file on the 
right-hand side. The left view then 
shows the contents of the file in the 
VCS (Figure 6). 

You can also transfer changes from 
Eskil to the VCS. To do this, click Com- 
mit, and enter a comment in the new 
window that opens. Next, close the 
input with Commit, and then click File 
and Redo Diff. Both views will now 
show no differences. 

You can also do this the other way 
round: If you want to modify local 
data, click on Revert. The content will 
then correspond to that of the VCS. 
View this with File | Redo Diff to up- 
date. 


CONCLUSION 

Eskil is a small, fine tool for all tasks 
related to comparing files and directo- 
ries. While there is some room for im- 
provement, it performed so well in our 
tests, that it is perfectly suitable for ev- 
eryday use. e 


[1] 
[2] Git: https:/git-scm.com 
[3] 


Eskil: http:/eskil.tcl.tk 


Fossil: http://www. fossil-sem.org/index.html/doc/tip/www/index.wiki 


During testing, when comparing di- [4] Mercurial: https:/www.mercurial-scm.org/ 


rectories, we found starting from the [5] Bazaar: http:/bazaar.canonical.com/en/ 

shell was fastest. [6] Apache Subversion: https:/subversion.apache.org/ 
| File Options Search Tools Help 
|Rev2 | Rev 2 | ios | Revet | Gommt | prevo | Netom | 


Figure 6: Eskil is compatible with several VCAs, but becomes unstable if you try to use them in parallel. 
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Discovery 
Guide} 


Look inside for a practical introduction to "4 
Ubuntu, including tips on printing and 
installing software, as well as installing, 
updating, and networking your Ubuntu system. 


Installing Ubuntu 17.04......... 
Network and Updates........... 
Package Management.......... 
MUTE Ciara ee, 


Ubuntu 17.04 offers almost no changes 
to the installation process. But, in case 
you are new to Ubuntu, we'll walk you 
through upgrading or installing the 
latest release. 


f you've installed Ubuntu in the past, 
you might notice that, unlike its pre- 
decessors up to 12.04, Ubuntu 17.04 
(Zesty Zapus) does not fit on one 
CD. As from 12.10 onwards, developers 
also improved the installer, which now 
provides full encryption and Logical Vol- 
ume Manager (LVM). The step in 13.10 
that allowed access to or set up of an 
UbuntuOne account was removed in 
14.04. Other than these updates, not 
much has changed with the Ubuntu in- 
stallation process in three years. 
Installing Ubuntu 17.04 on your com- 
puter or virtual machine can be done in 
several ways. Although Ubuntu is geared 
toward novice Linux users, installing the 
system is different from a Windows in- 


Espanol 
Esperanto 
Euskera 
Frangais 
Gadiige 
Galego 
Hrvatski 
Islenska 
allan 

Kurdi 

Latviski 
Uetuviškai 
Magyar 
Nederlands 
Norsk bokmal 
Norsk nynorsk 


Try Ubuntu 


shouldn't take too iong. 


You may wish to read the release notes. 


Installing Ubuntu 17.04 


INSTALLATION 
PP econ. 


stallation. We’ll explain your options 
and walk you through the steps. 


What's New, Zesty? 

If you're running Ubuntu 16.10, you 
can update to version 17.04 directly. 
However, if you’re upgrading from a 
version of Ubuntu earlier than 16.10, 
you will have to update in steps to 
16.10 first and then to 17.04. If you de- 
cide to go with a clean install, try the 
Live version first to test the programs 
and get used to the Unity desktop. 
Then, you can load the distribution via 
the integrated installer on your com- 
puter. Regardless of what you decide, 
back up all your important files first so 
nothing gets lost in the process. 


Install Ubuntu 


‘You can try Ubuntu without making any changes to your computer, directly from this CD. 


Orif you're ready, you can install Ubuntu alongside (or instead of) your current operating system. This 


Figure 1: Choose Try Ubuntu to run a Live instance on your computer without installing anything. 
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INSERT MEDIA 

The double-sided DVD that comes with 
this issue provides two versions of 
Ubuntu: one for 32-bit and another for 
64-bit computers. To boot from the 
DVD, first have your computer recog- 
nize it as bootable. Often computers 
do this automatically; starting the PC 
with a bootable CD or DVD in the 
drive invokes the corresponding boot- 
loader. If the computer can’t find the 
DVD, change the boot order via the 
BIOS. 

To get to the BIOS, start up the com- 
puter and immediately press Esc, Del, 
F2, or F12, depending on your com- 
puter. Then, look for the appropriate 
option to change the boot order and 
move the CD/DVD drive to the top of 
the list. If you’re starting Ubuntu from 
a USB stick, move the USB device to 
the top of the boot order. In both 
cases, save the setting and restart the 
computer. 

If your computer is missing a DVD 
drive, use a USB stick. We will assume 
that you already have Ubuntu in- 
stalled. Create the stick by download- 
ing the ISO image for Ubuntu 17.04 for 
the 32-bit or 64-bit architecture [1] 
that your installed Ubuntu uses, then 
load it to the USB stick using the 
Startup Disk Creator app in Ubuntu 
(Figure 2). First, delete all previous 
files on the stick, leaving at least 4GB 
of free space. At the top of the Make 
Startup Disk window, select the down- 
loaded ISO image; and, at the bottom, 
select the USB device to use, then click 
Make Startup Disk. Booting from the 
USB stick requires the BIOS setting 
previously mentioned. 
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Make Startup Disk 


To try or install Ubuntu from a removable disk, it needs to be set up as a startup disk. 


Source disc image (iso): 


CO-Drive/Image 


Disk to use: 


Device 


OS Version 


Capacity 


Figure 2: The Startup Disk Creator in U 


buntu 16.10 copies the Ubuntu 17.04 image onto a USB stick with 


the required free space. Both Ubuntu versions have to be for the same 32-bit or 64-bit architecture. 


To do a new installation, insert the 
DVD included in this issue into the 
drive with the DVD with the label fac- 
ing up for 64-bit architecture and 
down for 32-bit architecture, and then 
turn off the computer. Turn it back on 
and immediately hold down the Shift 
key, and you will get to the Ubuntu 
boot menu. Here, you can make a lan- 
guage selection using the F keys to set 
language, keymap, and boot parame- 
ters. 

Press F6 (Other Options) on the 
Ubuntu boot menu so that you do not 
land on the Ubuntu desktop. The win- 
dow has a Boot Options line at the bot- 
tom (Figure 3). Enter the boot options 
mentioned here instead of the default 


ubuntu® 


Figure 3: If booting doesn't work, adjust the boot option in the Ubuntu boot 


menu. 


one quiet splash. The nomodest, rad- 
eon.modeset, nvidia.modeset = 0, or 
nouveau. modeset = 0 options help if 
you have graphics problems and the 
screen stays black. The acpi=off boot 
option fixes power management prob- 
lems on older computers. 


If you do not want to Install Ubuntu 
right away, you can Try Ubuntu with- 
out installing. In Live mode, Ubuntu 
copies only the necessary programs 
into memory and executes them from 
there. Booting takes noticeably longer 
than the installed version, and the sys- 
tem as a whole is a bit slower, but you 
can test Ubuntu 17.04 with little risk. 
Also look at the bundled applications 


noapic 

nolepic 

edd=on 

nodmraid 
nomodeset 

Free software only 


updates. 
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Figure 4: The installer provides options, for MP3 support and downloading 


Harb Drives IN UBUNTU 


Ubuntu names device files on hard 
drives according to a particular 
schema: /dev/sda is the first detected 
hard drive, with /dev/sda7 its primary 
partition (/dev/sda2 through /dev/sda4 
are the three other primary parti- 
tions). The /dev/sda6 device is the first 
logical partition located in the (/dev/ 
sda2 extended partition. Windows 
should always be located in the first 
primary partition (/dev/sda7), and 
generally also in /dev/sdaz. If you 
plug a USB stick or external hard 
drive in the USB slot, these external 
storage devices are listed as /dev/sdb, 
with everything else following the 
same schema. Using the sudo fdisk -I 
command, you can get an overview 
of the available hard disk and USB 
memory, as well as the available par- 
titions and filesystems. 


to see whether Ubuntu supports your 
hardware (printers, scanners, wireless, 
and graphics cards). Ubuntu 17.04 
loads only the 3D version of the Unity 
desktop and uses LLVMpipe for slower 
machines, creating sluggish responses 
on some older computers (cause for a 
recommended desktop replacement). 


The Ubuntu installer opens in a win- 
dow as shown in Figure 4. First, 
choose a language. The next window 
checks whether your computer meets 
the installation requirements, which is 
at least 5.9GB available drive space, 
plugged in (important for laptop and 
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WINDOWS AND UBUNTU 


Windows likes to save its files across the entire hard disk. By defragging the Win- 
dows partition, you arrange the scattered file fragments in a contiguous region. You 
can then shrink the partition without destroying any installed programs. In Win- 
dows 7, you can start the defragging with Start / Programs | Accessories | System 
Tools. In Windows 8, use the search option to look for the defrag program. If you 
freshly installed Windows, a program called chkdisk routinely looks for damage to 
the partition, and then Windows can boot normally. 


After defragging, you can begin shrinking the Windows partition. At the bottom of 
the Start menu, type hard and click Create and format hard drive partition. Window 
XP and Vista have similar functions. 


Next, select the Windows partition you want to shrink. Right-click and choose 
Shrink Volume, enter a desired value in the Total size after shrink in MB field, click 
Shrink, and restart Windows. 


In any case, after you install Ubuntu and restart Windows, Windows resorts to chk- 
disk to check for possible damage. The system then restarts the computer again be- 
fore starting up normally. Wubi [2], the tool to install Ubuntu on Windows, is in- 
cluded with Ubuntu 16.10, and you will be able to use it up to Windows 7. Wubi 
only works with Windows 8 and 10 if the machine uses the old BIOS firmware and 
the hybrid sleep option is disabled. 


Installing Windows after Ubuntu is so complicated that we don’t recommend you 
do it. But, if you do plan to do so, choose to create a manual partition in the 
Ubuntu installer (as described in the “DIY Ubuntu” box) while reserving an empty 
/dev/sda1 partition for Windows. 


netbook installations), and preferably 
connected to the Internet. 

In this window, you can set two 
checkmarks. If you mark Download 
updates while installing, Ubuntu uses 
the idle time during installation to 
download patches and security up- 
dates from the Internet but doesn’t in- 
stall them yet. 

Marking Install this third-party soft- 
ware loads during Ubuntu installation 
a few important codecs and plugins for 
your system. These codecs and plugins 
will allow you to play MP3 files on 


This computer curranty has Ubuntu 16.10 0n it What would you Uke to do? 


Upgrade Ubuntu 14.39 Ubuntu 17.4 
Doenan os rete! prin ftw bebe. Pa 


tu 17.04 alongside Ubuntu 1610 
tc beat prea fet a het 


Use LVM withthe: 
‘on atl wt ve Lope vane pane Kw bing wpshets Pa erae Suro enning 


Something eise 
Yaseen reste pa ites yin, chose mst partner Unt 


Figure 5: Choose to erase the entire disk for the Ubuntu install or make a dif- 


ferent selection. 
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your player and see flash content in 
your browser. These two options can 
always be set later, so, for now, Next 
takes you to the next window. 

If a wired connection exists to the 
network and Ubuntu recognizes your 
wireless card, the next window displays 
the discovered access points. Using the 
correct password, you can connect to 
the access point. If no choices are avail- 
able, there may be a problem with your 
wireless hardware. For now, use a 
wired connection instead. 


place. 


Cuoices, CHOICES 

A new window then appears that was 
introduced in Ubuntu 12.10. If Ubuntu 
doesn’t find another operating system 
installed, it provides the options, as 
before, to Erase disk and install 
Ubuntu or to do Something else (Figure 
5). 

As from 12.10, there are two addi- 
tional options: Encrypt the new Ubuntu 
installation for security and Use LVM 
with the new Ubuntu installation. If 
you encrypt Ubuntu, the performance 
is a bit less than optimal, although it 
secures data against theft. Note that 
you can always encrypt your home di- 
rectory later. 

If you have another resident operat- 
ing system, such as Windows 8, the 
option Install Ubuntu alongside Win- 
dows 8 appears on the screen, which 
you can invoke using Continue. In this 
case, the options for encryption and 
LVM are grayed out and not available. 
If you have an older Ubuntu version, 
additional options appear in the in- 
staller window. 


UBUNTU FLYING SoLo 

Installing Ubuntu by itself takes up the 
entire hard disk and writes all files 
into the /dev/sdal primary partition. 
Also, the Ubuntu install creates the / 
dev/sda2 extended partition and, 
within it, the /dev/sdaS logical parti- 
tion that houses the swap area (see the 
“Hard Drives in Ubuntu” box). The 
swap area includes the swap file that 
takes over when working memory is 
overloaded, although writing to the 
swap area is noticeably slower than di- 
rect access to main memory. 


Figure 6: If you use the complete encryption that Ubuntu provides as an 
option, be sure to use a secure password (security key) and keep it in a safe 
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Usuntu NEIGHBORS 

Windows often takes up the entire 
hard drive instead. If you want to in- 
stall Ubuntu alongside Windows, you 
must shrink the Windows partition 
and completely defrag it, as described 
in the “Windows and Ubuntu” box. 
Ubuntu 17.04 then invokes the GRUB 2 
bootloader, which boots both systems 
and can handle new computers sup- 
porting Secure Boot. 


INSTALL Now 

If you opted for self-partitioning, click In- 
stall Now. To set up complete encryption, 
Ubuntu asks for a security key. Select the 
most secure one possible (Figure 6). 
Ubuntu then asks about your location 
(Where are you?, to get the time zone), 


REVIVAL 


Keyboard layout, name, username, and 
password (Who are you?). The latter dia- 
log also asks whether you want to Require 
my password to log in or Log in automati- 
cally, with an additional option to Encrypt 
my home folder. Ubuntu uses EcryptFS for 
this, 

The following screens are for selecting 
your timezone, keyboard, and setting your 
username and password. If you have one 
of the supported Ubuntu webcams, the in- 
staller also suggests that you take an 
image of yourself to complement your 
profile. Ubuntu 17.04 can also import pro- 
files from other installed operating sys- 
tems, including not only browser and 
email files, but also screen backgrounds 
and documents. 

During the install process, you can view 

a slideshow that 
presents the new 


features in Ubuntu. 
Installation can 


To revive an installed Ubuntu, boot up Live mode on the DVD 
in this issue by choosing the Try Ubuntu without installing 
option. Be sure that the Live and installed versions are the 
same architecture. Then, invoke a terminal and execute the 
following commands. Substitute for /dev/sda6 entry the spe- 
cific partition in which the root directory (/ of the installed 
Ubuntu is located. 


sudo mount /dev/sda6 /mnt 

sudo mount -o bind /dev /mnt/dev 
sudo mount -o bind /sys /mnt/sys 
sudo mount -t proc /proc /mnt/proc 
sudo chroot /mnt 

grub-mkconfig -o /boot/grub/grub.cfg 
update-grub2 

grub-install /dev/sda 

exit 


sudo reboot 


Use the chroot command (change root) to mount the in- 
stalled system into your Live system and work with it as if 
you had booted it. Now you can set up a new GRUB2. 


DIY UBUNTU 


If you want to maintain some control over the installa- 
tion, select the Something else option, although this op- 
tion requires some knowledge of the Ubuntu hard drive 
structure (see the “Hard Drives in Ubuntu” box). Ideally, 
you would place at least two logical partitions for 
Ubuntu on an empty hard drive: a swap partition (/dev/ 
sda5) and a partition for the root directory that is at least 
4.9GB (/dev/sda6). 


Optionally, add an extra partition for the /home directory 
(/dev/sda7) that gives you enough space for all your files. 
This partitioning has the advantage that you can install 
Ubuntu again later without losing your user data. Add 
the new partitions using Add. For the /and /home direc- 
tories, selecting the Ext4 filesystem is best. 
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take a while, de- 
pending on your 
system, and it ends 
with a prompt to 
Restart Now. Re- 
move the CD/DVD 
and press Enter so 
that the computer 
reboots. If you acti- 
vated system en- 
cryption, enter the 
password before 
booting up. 


UPDATING UBUNTU 
If you have Ubuntu 
14.04 installed, 
you may want to 
upgrade to 16.10 
instead of 17.04. 
Both versions are 


LTS versions, so 14.04 will be supported 
until 2019 and 16.10 until 2021. If you 
have an earlier version of Ubuntu, you 
will have to upgrade to the intermediate 
versions first. Before beginning, turning 
off the external repositories and PPAs 
makes sense. On earlier versions, prior 
to 17.04, use the Software Center Edit | 
Software Sources function and remove 
the check marks on the Other Software 
tab. 

Next press Alt + F2 and enter up- 
date-manager -d. In the empty window 
of the update manager, an Upgrade but- 
ton shows at the top. During the up- 
grade, the installer asks whether you 
want to keep or replace a specific config- 
uration file; choose to replace if you 
haven’t made any changes. Because 
Ubuntu is downloading many packages 
and replacing them, make sure your 
computer is plugged in to stay charged. 


BOOTLOADER FAILURES 

Occasionally, the bootloader doesn’t 
appear after an Ubuntu installation, or 
you can boot only one system. Loading 
Windows after installing Ubuntu often 
leads to a bootloader failure. Refer to 
the “Revival” box for commands you 
will want to enter in a terminal win- 
dow. These commands install the 
GRUB2 bootloader with help from a 
Live system so that GRUB correctly 
identifies all systems. e 


INFO 
[1] Download Ubuntu 17.04: http:/ 
releases.ubuntu.com/zesty/ 


[2] WubiGuide: https:/wiki.ubuntu. 
com/WubiGuide 


Figure 7: Installation can take a while, but it is painless and can generally be 
left to its own devices. 
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NETWORKMANAGER AND UPDATES 


NetworkManager and system updates 


ACTIVE TRAFFIC 


BY KRISTIAN KISSLING, PAUL BROWN 


fter the official release of a dis- 

tribution, the developers con- 

tinue to iron out bugs with vari- 

ous patches, and they continue 
to minimize security vulnerabilities dur- 
ing the entire support period of the oper- 
ating system. Ubuntu 17.04, for example, 
will be supported for the next 9 months. 
If you install the distribution a few 
weeks after its official release, updates 
are already available. 

To look for updates, call up the Soft- 
ware Updater program (Figure 1), which 
displays a list of installable patches. 
Clicking Install Now downloads the 
patches onto your computer (Figure 2). 
Restart the system to apply the patches. 
If no updates are available, you will see 
The software on this computer is up to 
date (Figure 3). 

Bug fixes help keep your system safe 
and secure. With a few exceptions, such 
as Firefox and Thunderbird, newer ver- 
sions of installed programs are updated 
with the next Ubuntu version. Within 
the support cycle of Ubuntu 17.04, only 
Backports and PPAs [1] can be applied to 
a new version. Backports are special re- 
positories that provide newer versions of 
some software [2]. 


With NetworkManager, you can access 
the Internet during the Ubuntu 
installation process. The first step is to 
download updates to make your system 
more secure. 


Figure 1: If Ubuntu updates are out there, you'll 
find out by invoking the “Software Updater” pro- 
gram. 


CHICKEN AND EGG 

To get updates for Ubuntu 17.04, you 
must have access to the Internet. The 
NetworkManager helps you set up that 
access during the installation. If you're 
not cabled in, the installer presents a 
window listing the neighboring wireless 
ea networks and asks you to connect to 

om one, which is when installation begins in 
earnest. 


Updated software has been issued sloce Ubuntu 17.04 was 
released. Do you want to install it now? 


a] 


software on this computer is up to date. 


Figure 2: Ubuntu shows details on what updates 
are waiting in the queue. 


Figure 3: No updates are needed and you are 
good to go. 
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To bypass this step, install Ubuntu 
without Internet access, and then later 
set it up through the NetworkManager, 
which is represented by a small icon at 
the top right of the screen. If you're 
using a wireless card, you will see a 
wave-shaped icon and, if the system is 
connected, the icon reflects the quality 
of the connection. Since Ubuntu 12.10, 
connecting to the Internet even before 
signing onto the desktop is possible. 


WIRELESS PROBLEMS 
Not all wireless cards work flawlessly 
with Ubuntu. Before you install Ubuntu 
on your computer, use the Live version 
to test whether Ubuntu recognizes your 
wireless chip. Boot into Live mode and 
try to connect to one of the wireless 
networks displayed. If connecting fails 
or no access points are showing, check 
the hardware switch on the computer it- 
self. 

If you run into problems configuring 
wireless cards, DSL modems, or UMTS 
sticks because NetworkManager doesn’t 
recognize them, temporarily connecting 
the computer with a network cable to a 
switch or router usually works. 

Hardware is a frequent source of 
wireless problems. On many notebooks, 
a button turns on the wireless card, 
whereas on others, a special key combi- 
nation (e.g., Fn+FS5) or a single F key- 
stroke works. Test to see whether the 
WLAN has been deactivated by mis- 
take. 

To enable access for DSL, UMTS, and 
so on, click in the upper right on the 
NetworkManager icon and choose Edit 
connections. Through Connection infor- 
mation, you can find out whether the ac- 
cess point provided you an address via 
DHCP (Figure 4). DHCP (Dynamic Host 
Configuration Protocol) is the service 
that automatically assigns you an IP ad- 
dress in the local net. Most routers pro- 
vide DHCP addresses by default. 
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Active Network Connections 
Wired connection 1 (default) Flippynet 
General 


Interface: 802.11 WiFi (wlp12s0)| 
Hardware Address: 00:1F:3C:B1:9B:FC 


Driver: iwis945, 
Speed: 54 Mb/s 
Security: WPA/WPA2 
IPv4 

IP Address: 192.168.1.114 


Broadcast Address: 192.168.1,255 
Subnet Mask: 255.255,255.0 


Default Route: 192.168.1.1 

Primary DNS: 192.168.1.1 

iPv6 

IP Address: fe80::c2c8:fb16:64af:9807/64 


Close 


Figure 4: Connection Information provides some 
helpful connectivity facts. 


ETHERNET 

Wireless routers usually have inputs for 
network cables. If the router assigns IP 
addresses with DHCP, which it usually 
does, NetworkManager automatically 
connects after you plug in the network 
cable. Rarely does this not work, but if 
that is the case, you must assign an IP 
address and domain name manually. 


WIRELESS NETWORKS 

So that Ubuntu can set up your wireless 
card properly, the kernel needs to find a 
suitable driver for the card. Then, it’s as 
easy as clicking the NetworkManager to 
obtain the neighboring networks (Figure 
5). Select the name of the wireless net- 
work and log in with your passcode. 

To avoid mistyping the password, make 
the password visible. Ubuntu automati- 
cally detects the encryption type (WEP or 
WPA) the access point uses. After a suc- 
cessful network authentication, your 
wireless card provides you with a valid IP 
address via DHCP. 

Setting up your smartphone (Android 
or iPhone) as an access point, which is 
called tethering, also works. Network- 
Manager treats the tethered smartphone 
as a normal access point and connects to 
it. Smartphones use the Universal Mobile 
Telecommunications System (UMTS) to 
get to the Internet, which is a good solu- 
tion when you are on the move. Don’t 
forget, however, to secure the access 
point on your mobile phone with a good 
password and deactivate it when you are 
done. 

If the kernel doesn’t provide a driver 
for your wireless card, a proprietary 
driver is usually available. To test this, 
press the Windows key and open the Soft- 
ware Repositories program. If the Addi- 
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nnect 


Flippynet 


FlippyNet 


Connect to Hidden Wi-Fi Network... 
Create New Wi-Fi Network... 

VPN Connections 

Enable Ne 

Enable Wi-Fi 

Con ion Information 


Edit Connections... 


Figure 5: NetworkManager displays the neigh- 
boring access points, which is generally the first 
choice when accessing the Internet. 


tional Drivers tab lists the driver for your 
card, click Activate so that the wizard can 
download the corresponding software for 
the card. 

If both steps don’t work, search online 
for Ubuntu 17.04 {YOUR WIRELESS 
CHIP}. To find out what your built-in 
wireless chip is called, press Ctrl + Alt+T 
to open a terminal and enter: 


$ lspci | grep “Network” 


For a USB device, use the following com- 
mand to find the chip’s ID number: 


$ lsusb 


An Ubuntu help page [3] lists the wireless 
card and its degree of support in Ubuntu 
and its derivatives. Setting up an unsup- 
ported wireless cards can be complicated 
on occasion, and other times a simple shell 
command can activate a card. In some situ- 
ations, programs such as Ndiswrapper 
allow use of the card’s Windows driver 
with Ubuntu [4]. 


UMTS Caros ann DSL Monems 
Using NetworkManager, you can also set 
up UMTS cards and chips, as well as DSL 
modems. Of course, the system must recog- 
nize the hardware; otherwise, the tabs are 
grayed out. Once Ubuntu identifies a UMTS 
card, insert the card into the USB slot, 
enter the PIN, and configure it using Net- 
workManager. 

DSL modems are also candidates for 
NetworkManager. Click Edit Connections 
and choose Add on the DSL tab, connect 
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the DSL modem to the phone jack and 
your computer via cable to the modem, 
and apply the access credentials from your 
Internet service provider. These credentials 
will go on the DSL dialog. 

Usually you will find a long line of text 
among the data, including the @ character. 
The part before the @ is your username, 
and the part after it is the service name. 
Then, enter the passcode and change to 
the Wired tab, where you enter the MAC 
address of the network card connected to 
your DSL modem. The name is usually 
eth0. After you determine the address, 
open a terminal and enter: 


$ /sbin/ifconfig | grep Hardware 


The MAC address consists of six two-char- 
acter sections separated by colons. Enter 
the MAC address in the field for the DSL 
configuration. 


VPN CONNECTIONS 

If you want to surf securely on the Internet 
through a tunnel, use a virtual private net- 
work (VPN) solution such as OpenVPN, 
which NetworkManager also supports. De- 
tails on OpenVPN and how it works with 
Ubuntu are in an article in Ubuntu User 
Issue 13, page 58-59. 


TROUBLESHOOTING 

If the DSL or UMTS modem is still giving 
you problems despite the correct driver, 
NetworkManager may have a bug. One so- 
lution is to install a recent version of the 
software by integrating a PPA. This pack- 
age often provides a newer version than 
the one normally used by Ubuntu. Often 
you can solve network problems by im- 
porting all updates for your release and re- 
starting the computer. e 


INFO 


[1] Packaging/PPA: https:/help. 
launchpad.net/Packaging/PPA 

[2]  UbuntuBackports: https:/help. 
ubuntu.com/community/ 
UbuntuBackports 

[3] WifiDocs/WirelessCardsSup- 
ported: https:/help.ubuntu.com/ 
community/WifiDocs/ 
WirelessCardsSupported 

[4] WifiDocs/Driver/Ndiswrapper: 
https:/help.ubuntu.com/ 
community/WifiDocs/Driver/ 
Ndiswrapper 

[5] Using OpenVPN Under Ubuntu: 
http:/www.ubuntu-user.com/ 
Magazine/Archive/2012/13/ 
Using-OpenVPN-Under-Ubuntu 
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The new Ubuntu Software app lets you 
install just about anything, including 
free software, purchased apps, and 
games. 


Software management in Ubuntu 17.04 


TODAY'S 


SPECIALS 


BY KRISTIAN KISSLING, PAUL BROWN 


buntu 16.04 introduced some 

changes to the way you install and 

manage extra software on your 

computer that live on in 17.04. 
Ubuntu’s tailor-made Software Center is gone, 
replaced by the lighter (and prettier) Gnome 
Software app (dubbed simply Ubuntu Soft- 
ware). You'll find some changes on the com- 
mand line, too. 

The new Software app provides centralized 
software management and allows you to 
search for new software and install it with a 
mouse click. With an Ubuntu One account, 
you can purchase software with a credit card. 

The Debian packages (ending in .deb) that 
the Software app offers are actually archive 
files containing libraries, configuration files, 
and executable programs. If you install the 
Firefox package, for example, the package 
manager distributes the necessary files to the 
correct places in the filesystem for you. 

Packages often have dependencies, which 
means installing program A requires that you 
have program B also installed. The package 
manager identifies the dependent packages 
automatically during installation and loads 
them onto your computer. Usually, you will 
notice the dependencies when you try to in- 
stall a single Debian package over the Internet. 

The package you are looking for, such as a 
video codec, may be missing in the Software 
app. In this case, you 


ronge 


can find the package in external repositories 
created by the software’s users or develop- 
ers. The repositories contain not only the 
software but also the packages on which 
they depend. (How to tap into these reposi- 
tories is covered in the “What Are Reposito- 
ries?” section.) 


PACKAGE MANAGER IN ACTION 

Getting to repositories and installing software 
is often faster from the command line. The 
“Quick Sources” section goes into greater de- 
tail. First, let’s look at managing packages 
using Ubuntu’s Software app. To access the 
Software app, press the Super key [1] and 
enter softw. The start page features the Edi- 
tor’s pick and Recommended games applica- 
tions, as well as a Featured Application at the 
top (Figure 1). 

If you scroll down, you'll see several cate- 
gory buttons. Click on any of the buttons, and 
you'll see a list of subcategories listed down 
the left-hand side of the window. Click on In- 
ternet, for example, and the list will show Fea- 
tured, All, Action, Adventure, Arcade, etc. 
Click on any subcategory, and you can browse 
for individual apps (Figure 2). Use the arrow 
icon in the upper left to return to the start win- 
dow. 

You'll find three other controls at the top of 
the package management window. The All 
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Figure 2: Clicking a subcategory on the left shows individual apps you can install. 


Figure 1: The Software app encourages you to browse. 
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tab lists all the software in all the available re- 
positories. This is the default view. 

The Installed tab displays only the installed 
applications, sorted by category. You can use 
this view to remove software you don’t want 
or need anymore. Downgrading, unfortu- 
nately, doesn’t work in the Software app. To 
do that you must install the Synaptic Package 
Manager and specify an earlier Version in the 
Properties. 

Updates shows new versions of installed 
programs that you will want to install to get 
rid of bugs and open vulnerabilities (Figure 3). 
Most updates will install automatically by de- 
fault, so this tab will usually be empty. You 
can disable this behavior in the settings. 

If you already know the name of the soft- 
ware, choose the All tab and use the search 
field at the top center of the view. Results 
show up as you type, and next to the software 
names are the ratings in the form of stars. You 
can install directly from the list or click on the 
programs icon and read more about the app. 

The app’s information screen will include a 
screenshot, a description, and comments from 
users, as well as information about the ver- 
sion, the license it is distributed under, and 
how much hard disk it will take up once in- 
stalled (Figure 4). Finally, click the Install but- 
ton to install the program. Once the program 
is installed, you can click the Write a review 
link to evaluate the software. This requires an 
Ubuntu One Single Sign-on account [2]. 

The search won't find all programs. The 
Software app does not list libraries or devel- 
oper files. To install these packages, you will 
have to use the apt command-line utility. 

To add other repositories, click on the 
Ubuntu Software drop-down menu at the top 
of the screen and choose Software and Up- 
dates (Figure 5). More on this later. 


Whar Are REPOSITORIES? 

The Software app gives you access to thousands 
of packages, but the one you want might be 
missing or only in an older version. This is 
where external repositories and the PPAs help. 


igure 3: Check for new versions of your software in the Updates tab. 


The Opera reposi- 
tory [3] is one such external repository, and it 
provides the Opera web browser that is miss- 
ing from Ubuntu’s standard repositories. The 
VirtualBox project [4] also provides the pro- 
prietary version of its own software, which 
supports the virtual USB 2.0 ports and Re- 
mote Desktop Protocol (RDP), from its own 
repository. 

Personal Package Archives (PPAs) are spe- 
cial versions of external repositories that you 
can only find on Ubuntu’s Launchpad. When 
experienced Ubuntu users or developers cre- 
ate Debian packages out of their favorite soft- 
ware, they frequently offer them in their per- 
sonal package archive on Launchpad. Using a 
search function [5], you can peruse the plat- 
form for new versions of current software 
with great success. 


COMPLEMENTING PACKAGE SOURCES 
As explained above, in the Software app, you 
can download from external repositories 
using Ubuntu Software | Software and Up- 
dates. To use the Opera project’s external 
sources, for example, click Other Software and 
Add, then enter deb http://deb.opera.com/ 
opera/stable non-free. This address wasn’t in- 
vented: Usually, the address is the website for 
the external repository. Click the Add Source 
button to accept the repository (Figure 6). 
External reposito- 
ries often protect 
themselves from 
abuse with keys. 
Every package has a 
signature verified 
with a key, so that 
manipulated pack- 
ages with mis- 
matched signatures 
fall by the wayside. 
Often, you can’t ac- 
cess a package offer- 
ing without a key, but 
how do you find the 
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Figure 4: Once you choose an installable package, you'll get further informa- 
ion on it: ratings, screenshots, descriptive text, and more. 


To import the key for the Opera repository, 
invoke a terminal through Ctrl + Alt + T and 
use the following command: 


$ sudo apt update 


The command updates the list of available 
software for the Software app and returns an 
error message. Then, enter: 


$ sudo wget -0 - 2 
http://deb.opera.com/archive.key 2 
| sudo apt-key add - 


For other repositories more tied in with 
Ubuntu, you may have to query the Ubuntu 
keyserver: 


$ sudo apt-key adv 2 
--recv-keys --keyserver 2 
hkp://keyserver.ubuntu.com:80 2 
B9A06DE3 


In this case, the preceding command downloads 
the appropriate key (B9A06DE3) for the devel- 
oper’s Launchpad PPA for the Inkscape vector 
design software and integrates it with package 
management. If you can’t get to the keyserver, it 
may be temporarily overloaded. Replace key- 
server.ubuntu.com in the command with another 
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Figure 5: Choose or add new repositories to access more software. 
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Enter the complete APT line of the repository that you want 
to add an source 


Figure 6: Obtain additional packages from exter- 
nal repositories. 


keyserver, such as subkeys.pgp.net, pgp.mit.edu, or 
keys.gnupg.net. After the sudo apt update com- 
mand, you should be able to install the software 
from the source. The new repository might not 
show up in the Software app right away. 


Key OVER TERMINAL 

As seen above, most websites show a simple 
line that you can copy with Ctrl +C and Ctrl+V 
to the terminal. The line might appear as in the 
following VirtualBox example: 


$ wget -q 2 
http://download. virtualbox.org/2 
virtualbox/debian/oracle_vbox.asc 2 
-0 - | sudo apt-key add - 


The command downloads the key from the 
website (using wget -q {HTTP-LINK}), sends it 
to the console (with -O -), and passes it to the 
sudo apt-key add command. Then, use sudo 
apt-get update to update the package list and 
load up the VirtualBox package. 


INTEGRATING PPAS 
With about 6,000 active PPAs on Launchpad, 
it is easy to get brand-new software versions 
with the latest functionality. Among them are 
exotic programs and (unstable) developer ver- 
sions of system components such as the ker- 
nel or NetworkManager. Before compiling 
software from the sources, first use a PPA 
search [4] to see whether a PPA might exist. 
The fastest way to integrate PPAs into the 
package manager is through the command inter- 
face because it saves you the key search. Press 
Ctrl + Alt +T to open the terminal and enter 
what usually amounts to three command lines, 
something like the following: 


$ sudo add-apt-repository 2 
ppa:inkscape.dev/stable 

$ sudo apt update 

$ sudo apt install inkscape 


These commands mount the PPA for the Inkscape 
vector drawing solution. For other software, simply 
replace the parts after ppa: and sudo apt-get install. 
Take the text for the part after ppa: from the website 
(Figure 7). It may take a while for the repository to 
appear in the Software app. 
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Figure 7: In this PPA, you'll find the current packages for Xenial Xerus to install the Inkscape design application. 


REMOVING SOFTWARE 

To remove software, open the Software app, 
search for the name of the software, and click Re- 
move. The configuration data is unaffected. The 
advantage is that you don’t need to reconfigure 
the software if you decide you need it again later. 
If these remnants (such as you might find in the 
/etc or /var directories) were to disappear, use 
the command line to remove the package. 


Quick Sources 

The Software app is a graphical interface for APT, 
the Advanced Packaging Tool, which manages the 
list of software in the repositories in the background. 
As already noted, you can also run apt over the 
command line; many experienced Ubuntu users 
prefer this method because the commands work 
with any Ubuntu derivative. Following are four im- 
portant commands: 


$ sudo apt update 
$ sudo apt search 2 
(--names-only) inkscape 
$ sudo apt install inkscape 
$ sudo apt remove (--purge) inkscape 


The first command brings the package list up to 


date. It is important to keep all the software on 
your system current considering how quickly 
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program versions change. The next line searches 
for a package with a name or description that in- 
cludes the term inkscape. Add the -names-only 
option (without the parentheses) to the com- 
mand to search for the package name only. The 
third line installs the package, and the fourth line 
removes it. Use the -purge option to purge the 
configuration files in the home directory along 
with the package. 

‘To remove all the packages installed through a 
PPA, either use the Software app and choose the 
PPA next to Installed. Another way to remove a 
package is to stay on the command line, install 
the ppa-purge package, and enter the following 
command: 


$ sudo ppa-purge ppa:inkscape/stable 
for the Inkscape example. 


SINGLE CONSIGNMENTS 

Finally, there are some websites that provide sin- 
gle Debian packages to download. To install the 
software, double-click the DEB package. Ubuntu 
then calls the Software app and recommends in- 
stalling the package. Once you click OK, the 
package appears together with a screenshot and 
description in the Software app. Finally, down- 
load the package with Install. e 


[1] Meta, super, and hyper keys: http:/askubuntu.com/questions/19558/ 
what-are-the-meta-super-and-hyper-keys 


[2] Ubuntu One Single Sign-On: https:/login.ubuntu.com/ 


[3] Opera repository: http:/deb.opera.com/ 


[4] VirtualBox project: http://www. virtualbox.org/wiki/Linux_Downloads 


[5] PPAs in Launchpad: https:/launchpad.net/ubuntu/+ppas 
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You can watch movies, play music and 
place calls over the Internet with ease 
with Ubuntu. You just have to load the 
right software packages onto your 
computer. We present some of our 
favorite multimedia apps. 


Multimedia components and proprietary programs 


THATS 


ENTERTAINMENT 


BY TIM SCHURMANN, MARCEL HILZINGER, PAUL BROWN 


laying movies and music, ripping 

DVDs, and making Skype calls - 

that’s all possible with Ubuntu. 

Although the Ubuntu installer al- 
ready provides basic “third-party” multi- 
media codecs, these options might not 
fulfill everyone’s wishes. At least, the dis- 
tribution loads the legitimate MP3 codec 
from Fluendo onto the computer through 
the ubuntu-restricted-addons package, 
along with components for the GStreamer 
framework (plugins-ugly, plugins-bad, 
ffmpeg) and a Flash plugin installer from 
Adobe. 

As a result, you can play MP3 files, burn 
audio CDs, and view more than 90 movie 
formats right after installation. However, 
the installed package is not compliant with 
the ubuntu-restricted-extras package that 
you should install after the installation. It 
provides additional codecs for GStreamer, 


brary 
D Play Queve 
BMusic 
Podcasts 
import Errors 
O radio 


ausen 
Dibret 
Playlists 

Q My Top Rated 

Q Recently Added 


some typical Microsoft fonts (that you need 
to sign an EULA for first) and the UnRAR 
unpacker. You'll also need to install the 
LAME library so that you can create and 
play MP3 files from audio CDs. 


GSTREAMER 

Generally, numerous programs in Ubuntu 
play music and movies, but there are some 
standard apps. Rhythmbox (Figure 1) is the 
preinstalled app for playing music. You can 
use the software to convert CDs to MP3 
format, although RipperX [1] is much bet- 
ter suited for this. Totem, on the other 
hand, is the default video player. This very 
simple player uses the GStreamer format. 
The drop-down menu used to access the 
videos and podcasts from YouTube and the 
BBC in the past is missing in the current 
version (Figure 2). Many users, however, 
also install VLC, the multimedia player that 


Q Recently Played 
Display 
visual Effects 
+-= 2 Requesting cover for Musk From The OC Mix. o 
Figure 1: Rhythmbox plays not only MP3s but also radio stations, and it provides integrated music 
shops. Better software exists for converting from audio CDs. 
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Videos 


MULTIMEDIA APPS 


Figure 2: Totem is becoming more and more minimalistic with every version. If you need more control 


over your media, VLC is a better option. 


plays everything, provides more features 
than Totem, and can be extended easily 
through modules. You can find these mod- 
ules using the command-line apt tool if you 
search with; 


apt search vic-plugin 


With CDs and DVDs fall from grace, there 
is no preinstalled default app for burning 
disks. You can still find Brasero in the 
Software app, however. Brasero provides 
an integrated cover editor. Although Bra- 
sero does not do Blu-ray recording. How- 
ever, K3B, also available in the Software 
app, does, although it will involve some 
system tweaking. Apart from K3B, you 
will have to install a special PPA that 
substitutes wodim, the default underly- 
ing disk-burning software, for cdrecord, a 
software that can handle Blu-ray disks. 
There are full instructions on how to do 
this online [2]. 

Running in the background for the pre- 
viously mentioned programs is 
GStreamer, which is a modular multime- 
dia framework that’s available to many 
audio and video apps. Thus, many pro- 
grams don’t need to support special co- 
decs because GStreamer provides the 
playback capability. To play an MP3 file, 
Rhythmbox hands over the task to 
GStreamer, which rummages through its 
resources for a plugin that takes care of 
the MP3 format. Using the contained co- 
decs, GStreamer converts the files into 
audible material (Figure 3). To teach 
Totem and Rhythmbox new data formats, 
often you can just install a matching 
GStreamer plugin. 
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DANGEROUS LIAISONS 

Although you can use these “limited ex- 
tras” for multimedia formats, you can’t 
watch encrypted DVDs - which covers 
just about all commercial DVDs. Well, you 
can but you have to bypass the Content 
Scrambling System (CSS). This requires 


libdvdcss2, provided by VideoLan [3], 
but this is considered a legal gray area 
in many countries. Use of this software 
is often banned because it cancels the 
CSS playback protection and is therefore 
considered to violate the “effective copy 
protection mechanism.” 

In some countries, you can resort to a 
commercial Linux program for legal play- 
back: the Fluendo DVD player [4], whose 
developers also participate in GStreamer. 
You can find the latter in the For Purchase 
repository. Until about a year and a half 
ago, you could turn to the Medibuntu re- 
pository. It used to house - apart from 
MPlayer and Mencoder - another codec 
package that you needed to play and edit 
movies in all formats. Medibuntu since 
has been closed and all of its packages 
have been moved to the main repositories 
(except for libdvdcss mentioned above). 


PARTNERS AND SHOPPING SOURCES 
Some proprietary applications like Skype 
and VMware View Client aren’t offered 
in the Ubuntu’s standard repositories. 
Although these programs might be free 
(as in beer), they’re often under proprie- 
tary licenses and are not provided with 
open sources. 
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Figure 3: Rhythmbox and Totem rely on the GStreamer framework that provides the necessary plugins 
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Figure 4: You can download and play games with Valve's Steam as you would on other platforms. 
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These third-party apps can often be 
found in the Canonical Partners reposi- 
tory that you must first activate. In Soft- 
ware app, click on the Ubuntu Software 
drop-down menu and then on Software & 
Updates, click the Other Software tab, 
then activate the Canonical Partners 
entry. Again, it might take a while before 
the sources appear in Software Center. 

The For Purchase repository has com- 
pletely disappeared from the latest versions 
of Ubuntu. If you really want to buy 
games, we recommend you install Valve’s 
Steam with 


sudo apt install steam 


Steam for Linux works exactly the same 
as for Windows (Figure 4). However, re- 
member that not all the games you can 
find for Windows work on Linux. Use 
Steam’s search functionality to find what 
you’re looking for and, in the column on 
the right, under the Narrow by OS section, 
click the SteamOS + Linux (Figure 5) to 
limit the selection to programs that work 
on Ubuntu. 

GOG also provides games for Ubuntu 
now, and a command-line utility called 
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Figure 5: Search for SteamOS+Linux to find games that will work on Ubuntu. 


lgogdownloader helps you manage down- 
loads, updates, and purchases from the 
site. 

That said, you can download some very 
cool free software games from the prein- 
stalled Software app. Click on the Games 
category, and you'll find a wide range of 
action, arcade, simulation, and puzzle 
games. Among our favorites, Minetest, a 
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fantastic open source mining, crafting, 
building, and survival game; OAD, a gor- 
geous-looking, civilization-building strat- 
egy game; PokerTH, which allows you to 
play the Texas hold ‘em variant of poker 
against computer rivals, on a local net- 
work or on public servers on the Internet; 
and finally, a front end for the MAME em- 
ulator, which will let you play thousands 
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Figure 6: Like Skype, Google Hangout provides video chat capability. 


of classical arcade and console games on 
your desktop. 


Apose PRobucTS 

Loading the flashplugin-installer package 
on the computer brings in the latest Flash 
versions direct from the Adobe website. 
You might have installed Adobe’s PDF 
Reader from the partner repository in the 
past. But, you will only need it if Ubuntu’s 
Evince built-in PDF viewer has break 
down opening a file - which does happen 
in rare cases with PDF files with 3D con- 
tent or very complicated graphics with 
many levels. For security reasons, you 
should avoid using Adobe Reader. 


SKYPE AND GOOGLE VIDEO 

Even the new version 4 of Skype is in the 
Canonical Partners repository. Apart from 
videotelephony, it also provides desktop 
sharing: To make collaboration easier, your 
conversational partner can peek at your 
desktop. Thanks to the new version, the 
image quality of Skype for Linux is gradu- 
ally matching that of the Windows client. 
Be aware, though, that Skype is one of the 
pieces of software that most spies on your 
communications. If you value your pri- 
vacy, don’t use it. 

As an alternative to Skype, check out 
Google’s Hangout video platform, which 
also allows calls among multiple partici- 
pants (Figure 6). You’ll need a Google ac- 
count, so register at the Google website 
and go to the left at the top of the 
Google + profile. In the right-hand col- 
umn, select Start Hangout and install a 
video plugin for your system. You can sim- 
ply download the corresponding DEB 
package and double-click the file manager. 

Google Hangouts are also suspect when 
it comes to user privacy. An experimental 
but very secure and private alternative is 
Tox [5] (Figure 7), a new, free, and open 
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protocol that implements peer-to-peer en- 
crypted live communication, including 
audio and video chats. Your best bet is to 
download the ÎŒTox client [6]; then, you 
just have to decompress it, and it is ready 
to use. 


Goosle EARTH 

Those who enjoy using Google Earth [7] 
can also install it in Ubuntu 17.04. Just 
download the corresponding Debian 
package for your architecture, and then 
go to Software Center and install the lsb- 
core package. Double-clicking the Google 
Earth package loads it on the computer, 
which can take a while mainly because 
the package grabs additional files from 
an online server. Be sure you have 
enough free space reserved. Then, you 
can start Google Earth by entering goog 
in the Dash. Be forewarned, however, 
Google Earth is no fun without proper 3D 
acceleration. 


THE New JAVA 

To use Java applications, you need a Java 
Runtime Environment (JRE). Ubuntu 
does not provide Oracle’s proprietary 
Java version anymore - only the free 
OpenJDK. Because some Java programs 
had problems in the past with OpenJDK, 
many users often resorted to the proprie- 
tary Java (sun-java). But, that’s missing 
now because Oracle put it under a non- 
free license. Because the proprietary Java 
is compatible with OpenJDK 8 - the offi- 
cial Java reference - most Java programs 
should be able to make do with the free 
Java. You can install the software from 
the openjdk-8-jdk and icedtea-8-plugin 
packages, and the older version from 
openjdk-7-jdk and icedtea-7-plugin via 
the following command: 


$ sudo update-alternatives --config java 


Figure 7: Tox is secure and keeps your conversations, even your video chats, private. 


This step activates one of the parallel in- 

stalled Java versions. If an app refuses to 

run, it’s best to submit a bug report at the 
Ubuntu wiki [8]. 


SEEK AND YOU SHALL FIND 

You can install many proprietary apps 
and multimedia codecs from the existing 
repositories. Numerous proprietary Win- 
dows programs also run in the Wine Win- 
dows-compatible environment [9]. Other 
than that, take a look in the Ubuntu pack- 
age manager, because almost any applica- 
tion has a free alternative. e 


INFO 

[1] RipperX: 
http://sourceforge.net/projects/ 
ripperx/ 


[2] Recording Blu-ray disks: https:// 
help.ubuntu.com/community/ 
CdDvd/Burning#Blu-Ray_Burning 

[3] libdvdcss at VideoLan: 
http://www. videolan.org/ 
developers/libdvdcss.htm! 

[4] Commercial GStreamer plugins: 
http:/www.fluendo.com 


[5] “Safe Communication with Tox” 
by Vincze-Aron Szabo, Ubuntu 
User, Issue 24, pg. 44: 
http://www.ubuntu-user.com/ 
Magazine/Archive/2015/24/ 
Safe-communication-with-Tox 

[6] ÎŒTox: 
https://wiki.tox.chat/clients/utox 

[7] Google Earth: http:/www.google. 
com/earth/index.html 

[8] Reporting bugs: 
https:/help.ubuntu.com/ 
community/ReportingBugs 

[9] Wine: http:/www.winehg.org/ 
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F COMMUNITY Faeroe 2 


The Fairphone 2 strives for a balancing act. As an open platform it offers easy repair and freedom 
of choice in terms of its operating system, while trying to ensure raw material mining and 
production take place under fair conditions. 


The modular smartphone Fairphone 2 


SMART AND FAIR 


BY CHRISTOPH LANGNER 


hese days even the electronics 

industry is trying to use fair 

trade products. The challenge 

here is not only to manufacture 
them under truly fair conditions, but 
also for the raw materials for elec- 
tronic circuits and batteries, such as 
tin, tantalum, tungsten, or gold, to be 
purchased without indirectly financing 
conflict areas. 


Currently there are no such initia- 
tives in the industry overall, but the 


Fairphone company [1], which is 
based in the Netherlands, is leading 
the way with their second-generation 
smartphone, the Fairphone 2, available 
from their online store [2]. The first 
model Fairphone FP1U (as well as a 
slightly revised version of the same) 
sold out with more than 60,000 units 
purchased; the Fairphone Company 
hopes to beat this success with their 
second model [3]. 
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FAIRPHONE 


The first-generation Fairphone was 
produced under license, but the new 
model was developed independently. 
Fairphone claims this gives them 
greater influence over production con- 
ditions, materials used, and the supply 
chain. In addition, the developers paid 
particular attention to durability when 
designing the phone. Many compo- 
nents can be swapped out. 

Technically, the Fairphone 2 is based 
on the Qualcomm SoC MSM8974AB, 
which also powers devices from estab- 
lished manufacturers, such as the HTC 
One M8 or the Samsung Galaxy S5 
(see Table 1). In combination with 
2GB of RAM and 32GB of internal 
memory space (which can be up- 
graded via a microSD card slot), the 
device is suitable for everyday use de- 
spite the already slightly antiquated 
processor. The exchangeable battery 
will last at least a full day. 


MODULAR 
While most smartphones have to be 
repaired or even thrown away after 
minimal damage due to integrated bat- 
teries and glue-on housing, the Fair- 
phone 2 can be fully dismantled eas- 
ily. On the iFixit Repairability Scale, 
the device is the only smartphone to 
score 10 out of 10 points [4]. Spare 
parts such as batteries and displays, as 
well as building blocks such as the 
camera module, are available from the 
Fairphone store from EUR20 upwards 
[5]. The display is about EUR85, 
which is the most expensive spare 
part. Fairphone plans to offer new 
components in the future [6]. 

The device is shipped with Fair- 
phone OS, which is installed after 
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Fairphone Privacy Impact 
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Fairphone wants you to know how your 
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Figure 1: The Fairphone OS has no superfluous applications. 


downloading the updates for version 
1.11.1. The system is based on An- 
droid 5.1 “Lollipop” and has only been 
slightly modified. For example, when 
launching apps, it indicates whether 
they affect your privacy (Figure 1). 
Fairphone promises to continue sup- 
porting the software for two years by 
releasing updates [7] to fix blatant er- 
rors or security gaps. 

So far, device owners have waited in 
vain for an update to Android 6 “Marsh- 
mallow” (or newer). The community 
manager of the Fairphone project, 
Douwe Schmidt, wrote last November 
that the update should be “ready in the 
coming months” [8]. In January, Fair- 


LISTING 1: FLASHING UBUNTU ONTO THE FAIRPHONE 2 (1) 


$ sudo apt-get install ubuntu-device-flash phable-tools 


$ sudo ubuntu-device-flash --server=http://system-image.ubports.com touch 


~-channel=ubuntu-touch/stable 


FasTBooT MODE 


--device=FP2 --bootstrap 


In the fastboot mode, the mobile phone looks as if it’s crashed. The display shows 
only the Fairphone logo, and the controls are missing. Use the command sudo fast- 
boot devices to check if the mobile phone is in the correct mode and if the com- 


puter can see it. 
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TABLE 1: SPECIFICATIONS 


Display 5 inches, 1080x1920 pix- 
els, 446ppi 

Operating 

system 

SoC 


Android 5.1/Ubuntu 
Touch possible 


Qualcomm MS- 
M8974AB 


Snapdragon 801 
2.26GHz quad-core 


Qualcomm Adreno 330 
GPU (578MHz) 


2GB LPDDR3 


32GB eMMCS5, microSD 
slot 


2420mAh (interchange- 
able) 


8MP (2.2), 2MP (back) 


LTE, 802.11b/g/n/ac, 
Bluetooth 4.0 LE 


143mmx74mmx11mm, 


Memory 


Battery 


Cameras 


Dimensions 


(HxWxD) 168 grams 
Price EUR523.33 
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Figure 2: Use recovery mode to install Ubuntu Touch. 


phone’s Twitter channel announced the 
long awaited update would be available 
“in weeks” [9]. There have been no fur- 
ther announcements since then. 


LISTING 2: FLASHING UBUNTU ONTO THE FAIRPHONE 2 (II) 


iHHE Switch off the mobile phone and connect it to the computer via USB 


#ht and [Fast] + [Power] to Fastboot mode. 


{HHF The Fairphone logo on the display. 
$ sudo fastboot devices 
Fbecf69e fastboot 


$ sudo ubuntu-device-flash --server=http://system-image.ubports.com touch 
--channel=ubuntu-touch/stable --device=FP2 --bootstrap 


2017/02/09 19:53:28 Device is | FP2 | 


2017/02/09 19:53:28 Flashing version 15 from ubuntu-touch/stable channel and server http:// 


m-image.ubports.com to device FP2 

Can not boot recovery image 

Unplug the mobile phone from the USB connector and remove the battery. 
{HHF Then insert the battery, plug in the USB and press 

#H# [Lauter] + [Power] to recovery mode. 


$ sudo adb devices 


List of dev attached 
Fbecf69e recovery 
$ sudo adb shell mkdir /cache/recovery 


$ sudo ubuntu-device-flash --server = http://system-image.ubports.com touch --channel = 
ubuntu-touch/stable --device=FP2 
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As an alternative to the preinstalled 
system, there is an open source ver- 
sion of the operating system (OS) 
called Fairphone Open [10]. It uses no 
proprietary components (except the 
binary blobs required for hardware 
support) and is aimed at users who 
prefer a free and open system unasso- 
ciated with Google. Apps can be in- 
stalled using the open source market 
F-Droid [11]. 

Alternatively, applications such 
as YalpStore [12] or Raccoon [13] 
provide the ability to download ap- 
plications in the form of APK files 
from the Google Play Store without 
installing the complete Google 
framework on your phone. The 
Open version of the Fairphone OS 
also can be rooted directly from 
the Settings menu and is updated 
monthly. 

If necessary, Fairphone Open can 
also install Google Apps using Open 
GApps [14], making it a “fully fea- 
tured” Android system with root privi- 
leges. 
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[12] Fairphone 2 - FP2 
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ter number: $ 
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Figure 3: Magic-device-tool theoretically makes Ubuntu Touch installation easier. 


UBUNTU 


Canonical has pulled the plug on 
Ubuntu Touch, despite the company 
showcasing the Bq Aquaris M10 [15] 
and the Meizu PRO 5 Ubuntu Edition 
[16], which both use Ubuntu Touch, at 
the most recent Mobile World Con- 
gress in Barcelona. That said, this 
year, in tandem with the Dutch IT spe- 
cialist Smoose, they plan to present 
Ubuntu Touch for the Fairphone [17]. 

Work on the Ubuntu port is now co- 
ordinated by the UBports project [18]. 
Currently the OnePlus One, the Nexus 
5, and the Fairphone 2 are at the top of 
their priority list. Except for GPS, 
Ubuntu Touch supports the Fairphone 
2’s hardware completely [19]. All 
three devices are therefore suitable for 
everyday use. 

In order to install Ubuntu Touch on 
the Fairphone 2, download the devel- 
oper tools on an Ubuntu-equipped 
computer and then flash the smart- 
phone with the Ubuntu system (List- 
ing 1). First, you should back up all 
data on the mobile phone, as the in- 
staller erases the device memory and 
automatically downloads the approxi- 
mately 400MB Ubuntu image from the 
Internet - at least in theory. 

In practice, however, this simply 
doesn’t work. The description on the 


download page for booting the device 
to the fastboot mode is incorrect (see 
the Fastboot Mode box). You can’t do 
this by pressing Volume Up and the 
Power button when booting, but in- 
stead by pressing Volume Up and 
Power Down. 

Next, execute the second command 
from Listing 1. At the end of the test, 
it may fail with the message Cannot 
boot recovery image. Temporarily dis- 
connect the device from the USB cable 
and take the battery out. Switch the 
phone on again holding Volume Up 
and Power Down. 

In recovery mode (Figure 2), you 
can check the Fairphone 2 using the 
touch screen. The computer should 
automatically find the phone in this 
mode using sudo adb devices. For fur- 
ther flashing, set the missing directory 
/cache/recovery on the telephone and 
repeat the command ubuntu-de- 
vice-flash. Finally use the command- 


LISTING 3: USING MAGIC-DEVICE-TOOL 


$ sudo apt install git 


$ git clone https://github.com/ 


MariusQuabeck/magic-device-tool .git 
$ cd magic-device-tool 


$ ./launcher.sh 
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Let the Editor Wars Begin! 

Editors, particularly command-line editors, are an important tool 
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immediately,... 
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hard disks, and you'll have to leam some new techniques if you 
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line option --bootstrap. The order of 
commands, including outputs, is 
shown in Listing 2. 

During testing, flashing the Fair- 
phone 2 with Ubuntu Touch ran with- 
out any recognizable errors, but when 
the device restarted it was still using 
Android. To this end, we hit upon 
magic-device-tool [20], which facili- 
tates the flashing of Ubuntu Touch on 
a number of compatible devices (in- 
cluding the Fairphone 2). 

As shown in Listing 3, download the 
script to the Ubuntu system from the 
GitHub repository, run it, and then se- 
lect the installation of Ubuntu Touch 
on the Fairphone using 12 (Figure 3). 
Next, follow the instructions in the 
window. You can enter fastboot mode 
with the Volume Down + Power but- 
tons. Enter recovery mode with Vol- 
ume Up + Power. 

This also didn’t work. The Fair- 
phone didn’t boot to Android this 
time, but hung on startup. 

To make a long story short, install- 
ing Ubuntu Touch on the Fairphone 2 
is anything but an automated process. 
In theory, the process will get easier 
over time. That said, Smoose [17], the 


company behind UBports, was kind 
enough to send us a phone with 
Ubuntu preinstalled for testing pur- 
poses, and it worked well. 


ConcLusioN 

The Fairphone 2 cannot be described 
as eye candy. The materials and hap- 
tics fall far behind brand-name de- 
vices. However, when used inten- 
sively, this becomes rather superficial. 
Unlike fancy brand-name smart- 
phones, any dented metal frames or 
cracked glass can be repaired cost-ef- 
fectively on the Fairphone. 

Even the choice of software affords 
you greater freedom than Samsung, 
Sony, and others. The preinstalled An- 
droid image does not include built-in 
bloatware like Facebook or other ven- 
dor-specific services. If necessary, use 
Fairphone Open to eliminate all 
Google services from your mobile 
phone. 

We did have a fairly rough time in- 
stalling Ubuntu Touch. But since Ca- 
nonical touts the Fairphone as being 
officially compatible with their OS, 
this state is hopefully only temporary. 
Watch this space. e i 


INFO 


[1] Fairphone: https//www.fairphone.com/ 
[2] Fairphone 2: https:/shop.fairphone.com/en/ 


[3] “Fairphone 2 production and delivery countdown!": https/www.fairphone.com/en/2015/12/10/ 
fairphone-2-production-delivery-countdown/- 


[4] Smartphone repairability: https:/www.ifixit.com/smartphone-repairability 
[5] Spare parts: https:/shop.fairphone.com/er/spare-parts 
[6] Fairphone 2 Hands-On: https:/arstechnica.com/gadgets/2015/10/airphone-2-hands-on-modular-phones-are-finally-here/ 


[7] “What is the plan for software updates on the Fairphone 2?”: https:/fairphone.zendesk.com/hc/en-us/articles/ 
205504175-What-is-the-plan-for-software-updates-on-the-Fairphone-2- 


[8] Update to “Marshmallow”: https//forum.fairphone.com/vandroid-6-0-marshmallow-7-nougat-for-fp2/9585/240 
[9] “Android 6 is coming within weeks”: https:/twitter.com/Fairphone/status/82209 1694443270145 
[10] Fairphone Open: https/code.fairphone.com 

(11] F-Droid: https:/-droid.org 

[12] YalpStore: https:/github.com/yeriomin/YalpStore 

[13] Raccoon: https:/github.com/onyxbits/Raccoon 

[14] Open GApps: http:/opengapps.org 

[15] Ubuntu on mobile devices: https,/developer.ubuntu.com/en/phone/devices/ 

[16] Meizu PRO 5 Ubuntu Edition: http://www. meizu.com/en/products/pro5ubuntu/summary.html 
[17] Smoose (site in Dutch): https:/Awww.smoose.nl 

[18] UBports: https:/ubports.com 

[19] UBports (Fairphone 2): https:/devices.ubports.com/#/FP2 

[20] magic-device-tool: https:/github.com/MariusQuabeck/magic-device-tool 
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— KDE Sumeook COMMUNITY ‘i , 


The KDE Slimbook bolsters the ranks of Linux notebooks with this good-looking and powerful 
Ultrabook. 


Putting the KDE Slimbook through its paces 


STRONG AND 
LIGHTWEIGHT 


BY FERDINAND THOMMES 
Ithough Linux-compatible available to test their software. The 
hardware is not nearly as seri- colleague with whom you're working 
ous an issue nowadays as it on a project probably does not own 
was, it’s still something of a an identical notebook with compati- 
minefield. This applies, in particular, ble hardware. The KDE developers 
to peripherals, such as multifunction have now come up with a solution to 
printers, but also to other hardware this. 
like notebooks. The KDE Slimbook is The Slimbook, like Dell’s XPS se- 
a notable exception [1], as it already ries, is primarily aimed at developers 
comes with a preinstalled and Linux fans. In designing the 13.3- 
and configured Linux op- inch small Ultrabook, which bears a 
erating system. striking resemblance to the MacBook 
Compatibility is not Air, KDE Project developers wanted 


only an issue for end users, hardware that would work seamlessly 
but also for software devel- with the operating system, Plasma en- 


opers, who have only a vironment, KDE applications, and 
limited selection of KDE frameworks. 
hardware 


ONE FOR ALL? 

The KDE Slim- 
book not only 
provides the 

KDE developers 
with a comparable work 
base, but also ensures that de- 
vice owners have the same hardware 
compatibility issues they do when 
using software. Last year Jonathan 
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Figure 1: The Fairphone OS has no superfluous applications. 


Riddell, former lead KDE developer, 
took the first steps towards estab- 
lishing a common base. 

With the release of the project 
KDE neon, developers created a ref- 
erence operating system, which 
made two out of three potential 
error sources easier to compare. The 
operating system and desktop envi- 
ronment were already in place, only 
the hardware remained a great un- 
known. The KDE Slimbook is de- 
signed to provide a solution to this 
problem and to serve as a reference 
platform for this third component 
(Figure 1). 


OLD FAITHFUL 

The KDE Project provided us with 
one of their first Slimbooks for a 
week. We received the more power- 
ful version running an Intel i7-6500U 
processor with a clock rate of 
2.5GHz. Our testing machine had 
8GB of DDR3 RAM (the standard is 
4GB) at 1600Mhz. The basic model 
is equipped with an Intel i5-6200U 
CPU with a clock rate of 2.3GHz. 
The prices for both models without 
any hardware upgrades are EUR729 
(~ $797) and EUR849 ( ~ $928) re- 
spectively. Our test model was worth 
EUR909 ( ~ $994). The manufacturer 
offers a two-year warranty. 

Both processsor types are dual 
core, which use hyperthreading 
based on the Intel HD-520 integrated 
graphics unit. The economical ultra 
low voltage (ULV) processors offer a 


thermal design power (TDP) of 12W 
or 15W. The Intel platform used is 
called Skylake, which has now been 
succeeded by Kaby Lake. 

The Slimbook’s RAM can be up- 
graded up to 16GB (Figure 2). 


UNDER THE Hoop 

The Slimbook has an aluminum case 
measuring 33x22x1.8cm and weighs 
1.36kg. The backlit keyboard offers 
a variety of English or European lay- 
outs. Data is stored on a 120GB 
mSATA-SSD, which can be upgraded 
to a 250GB or 500GB model for an 
extra charge. 

The matte 13.3-inch IPS LED dis- 
play will display full HD video 
(1920x1080), providing a pixel den- 
sity of 166 PPI. Screen brightness is 
a respectable 355 cd/m2. You can 
connect the Slimbook to the outside 
world via WLAN with the Intel Dual 
Band Wireless-AC 3160. Alterna- 
tively, the Intel Dual Band 726 5N or 
Wireless-AC 7265 are available, 
which also provide Bluetooth 4.0. 

The Slimbook has two USB 3.0 
ports, a mini HDMI port, and a slot 
for SD and MMC cards. The hard- 
ware specification also includes a 
front-facing 1MP webcam. The lith- 
ium-ion battery has a nominal power 
of 6 800mAH, but the manufacturer 
hasn’t said how long this should 
last. Some online reports claim the 
device has a rather unrealistic run 
time of up to 12 hours. In our tests, 
the battery lasted an average of 
seven hours. 


ELEGANT 

After unboxing and handling the 
Slimbook for the first time, it’s 
clear the device fits snugly into 
your hands and is nothing less 
than elegant. The aluminum lid is 
decorated with the combined logo 
of Slimbook and KDE (Figure 3). 
On closer inspection, it turns out 
the casing is quite familiar, sharing 
its basic structure with last year’s 
Tuxedo InfinityBook and the Schen- 
ker S306. 

Along with our test equipment, be- 
side the notebook and the charging 
cable itself, we received a USB Ra- 
link MT7601U wireless dongle, 
which can provide better throughput 


UBUNTU USER + WWW.UBUNTU-USER.COM 


Figure 2: The command-line program Inxi reveals what is in the Slimbook. 
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Figure 3: There's a combined KDE/Slimbook logo on the center of the lid. 


includes creating a user account and 
setting up WiFi amongst other 
things. Despite being told we could 
use wireless right away, we found 
WLAN only worked after rebooting 
the Slimbook. However, it then 
worked properly via the network 
manager over further restarts, as 
well as when waking from sleep. 


{HABLA ESPAÑOL? 

The Slimbook offers new users a 
kind of setup assistant called Slim- 
book Essentials, but at the time of 
testing, it only worked in Spanish. 
Non-Spanish speakers can use this 
with some help from Google Trans- 
late (Figure 4). The developers, how- 
ever, assured us that there will be an 
English version. The app is also 
available in the Launchpad as a PPA 
Bi: 

The Aplicaciones tab is still easy 
to use even without a translator. It 
allows you to install programs like 
Google Chrome, Gimp, VLC, or 
Wine, as well as unblocking services 
like SSH or NFS. The individual task 
progress is shown in a console to the 
right of the window. 

The tab Ajustes (Adjustments) 
contains switches for system set- 
tings, such as an optimization line 
for the SSD in the / etc / fstab file, 
Contrib-, and Non-Free Options in 
sources.list. You can also configure 
Bluetooth or WiFi or update the en- 
tire system. Utilidades contains vari- 
ous system information and tests, as 
well as the ability to remove old ker- 
nels. 


CONVENIENT KEYBOARDS 

In order to get the correct layout, 
check the system settings under 
Input Devices | Keyboard | assign- 
ments, and then set the keyboard ac- 
cordingly. 

The keyboard has 101 keys. Our 
pre-production model was missing 
the characters <, >, and |. On the 
Slimbook website, the keyboard 
shown also seemed to be missing the 
pipe sign. The overall typing experi- 
ence is pleasantly precise and not 
spongy as can be the case for note- 
book keyboards. For working in 
darker environments, the backlight 
can be set to various intensities via 
Fn +F5. 


AN Apequate SSD 
The already somewhat mature mSata 
SSD Kingston mS200 with 120GB ca- 
pacity has a reading speed of just 
under 400MByps, reaching about 
200MByps when writing. More mod- 
ern SSDs are faster. Nevertheless, the 
bundled drive is compatible with the 
system and should be sufficient for 
most users. It’s also several times 
faster than conventional mechanical 
hard disks. If you need a larger SSD, 
however, it may be better to order the 
standard 120GB drive and replace it 
with a better one yourself. 
Upgrading components such as 
RAM, SSD, or the WLAN module is 
very user-friendly. You just need to 
loosen the 12 screws on the back 
cover to reach them. 


Low Noise 
The strategically placed gaps in the 
aluminum housing make for good 
heat dissipation and will likely keep 
the Slimbook ticking over nicely. 
This in turn makes itself felt in a 
pleasantly quiet working environ- 
ment. During testing, we transcoded 
a video using the editor Handbrake, 
which loaded the CPU on all four 
cores to over 90 percent. Only when 
we placed our ears very close to the 
casing did we hear a low noise. Even 
using the stress tester cpuburn, 
which constantly serves a 100% load 
on all cores, the fan remained inau- 
dible at a distance of 30cm. 

In order to get a comparable test of 
the main components, we installed 
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Figure 4: The setup assistant Slimbook Essentials was only available in Spanish on our test Ultrabook. 
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ISSUE 33 


the Phoronix Test Suite (PTS) [3] 
from the vendor site as the Ubuntu 
version was completely out of date. 
We used the Universe suite, which of- 
fers the most extensive tests [4]. 


CoNcLusION 

Our testing week with the KDE Slim- 
book was fun. There were many 
good points, but also a few bad 
ones. Thanks to the aluminum case, 
this 1.36kg, very portable Slimbook 
is a joy to handle, both cool and 
stylish. The area on the left and 
right of the touchpad warms up only 
slightly, even for very demanding 
tasks. 

The Slimbook worked smoothly 
without any issue. It certainly seems 
suited for developers, who fre- 
quently need to collaborate on com- 
piling compatible software. For gam- 
ers, the integrated graphics unit 


INFO 


might be sufficient, but not for hard- 
core players. 

The matte screen and the fact the 
fans are barely audible, even for 
heavy tasks, make the Slimbook 
even more agreeable. 

The decision to use Intel’s Skylake 
instead of the latest generation Kaby 
Lake plays a key role in terms of pric- 
ing, which is comparatively moder- 
ate. However, the RAM should be 
DDR4-2133 instead of DDR3-1600, as 
the motherboard supports this. 

Our criticism is otherwise limited 
to two things. Firstly, the Spanish- 
only setup app Slimbook Essentials 
was not yet available in English 
when the device went on sale in 
April. Secondly, the keyboard has 
not yet been optimally designed. 
However, this should be remedied in 
devices that are shipped to end 
uses. e 


n] 


KDE Slimbook: https:/slimbook.es/en/store/slimbook-kde 


[2] Slimbook Essentials: https:/launchpad.net/~slimbook 
[3] PTS: https:/www.phoronix-test-suite.com/ 
[4] PTS results: https:/openbenchmarking.org/result/1704081-RI-KDESL526386 
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